Go unique.Make 怎样读取受限根目录中的文件

先把职责分开：unique.Make 不打开文件，也不解析路径。它接收一个满足 comparable 的 Go 值，返回可比较的 unique.Handle。要从受限根目录读取文件，应先用 os.DirFS 建立文件系统视图，再用 fs.ValidPath 检查相对路径，最后调用 fs.ReadFile；读取成功后，才把内容或业务键交给 unique.Make。

先把读取职责交给 os.DirFS 和 io/fs

Go 1.23 才加入标准库 unique 包。它解决的是字符串、结构体等可比较值的规范化问题；文件读取仍然属于 io/fs 和 os 的职责。下面这条链路适合“只允许访问某个目录下的相对文件名”的普通工程场景：

package main

import (
    "fmt"
    "io/fs"
    "os"
    "unique"
)

// readAndIntern 先限制路径，再读取文件，最后规范化文件内容。
func readAndIntern(root, name string) (unique.Handle[string], error) {
    // ValidPath 拒绝空路径、绝对路径和包含 .. 的路径。
    if !fs.ValidPath(name) {
        return unique.Handle[string]{}, fmt.Errorf("invalid relative path: %q", name)
    }

    // DirFS 把后续文件名解释为 root 下的相对路径。
    view := os.DirFS(root)
    data, err := fs.ReadFile(view, name)
    if err != nil {
        // 不存在、无权限或读取失败都在这里返回给调用方。
        return unique.Handle[string]{}, fmt.Errorf("read %q: %w", name, err)
    }

    // 文件内容是 comparable 的 string，可用于内容级去重。
    return unique.Make(string(data)), nil
}

func main() {
    handle, err := readAndIntern("./assets", "config/app.toml")
    if err != nil {
        fmt.Println(err)
        return
    }

    // Value 返回产生 Handle 的值；Handle 本身不是 *os.File。
    fmt.Println(handle.Value())
}

这里的“受限”是文件系统视图和路径格式的限制，不应直接宣传成安全沙箱。os.DirFS 仍可能受根目录中的符号链接影响；面对不可信租户文件、强安全隔离或竞态攻击，应选用目标 Go 版本提供的更严格根目录 API，并单独设计权限模型。

读取成功后，再用 unique.Make 规范化值

unique.Make 的价值在第二层：多个读取结果如果转换成相等的字符串，就能得到相等的 Handle。比较 Handle 通常比反复比较较长的内容更便宜，适合做内存中的内容身份、标签或缓存键。它不会替你判断路径是否存在，也不会为字节切片自动建立稳定身份。

// 同一内容会得到相等的 Handle，适合做内容身份比较。
first := unique.Make("mode=readonly")
second := unique.Make(string([]byte("mode=readonly")))

fmt.Println(first == second) // true
fmt.Println(first.Value())   // mode=readonly

// []byte 不是 comparable，不能直接作为 unique.Make 的类型参数。
// 需要先复制或转换成 string，并明确这次转换的内存成本。

四个 API 的边界要分清

因此，排查“读不到文件”时先看根目录、相对路径、权限和错误值；排查“重复内容没有合并”时再看传入 unique.Make 的值是否真的相等。把两类问题混在一起，通常只会错误地给 unique.Make 增加它并不存在的文件语义。

版本与采用建议

代码依赖 Go 1.23 或更高版本，因为 unique 是 Go 1.23 引入的标准库包。若项目仍需支持更早版本，应先通过模块版本策略确认兼容范围，不要只在单个文件中替换导入路径。生产实现还应记录读取失败的文件名和错误类型，但不要把未经清洗的路径直接写入日志或返回给外部用户。

相关问题

unique.Make 能直接接收文件路径吗？

能接收作为字符串的路径值，但那只是规范化“路径文本”，不会读取该路径指向的文件。要规范化文件内容，必须先完成读取。

为什么不能把 []byte 直接传给 unique.Make？

切片不是可比较类型，不能满足 T comparable。可以转换为 string，但要评估复制和驻留内容带来的内存成本。

Handle 可以当作 *os.File 使用吗？

不可以。Handle.Value() 只返回创建 Handle 时的值的浅拷贝；文件打开、关闭和读取生命周期仍由文件 API 管理。