Go fs.Sub 怎样给子目录创建文件系统视图

Go 中可以调用 fs.Sub(source, "assets/docs")，把父文件系统的子目录作为一个新的 fs.FS 视图。此后读取 welcome.txt 对应父系统里的 assets/docs/welcome.txt，组件不必继续拼接目录前缀。

官方文档：https://pkg.go.dev/io/fs

先让组件只接收自己的资源根

假设帮助面板需要欢迎文本和快捷键说明，而资源包里还放着主题文件。组件如果到处写 assets/docs 前缀，目录调整时就要修改许多读取位置。更合适的契约是由组装代码选择子目录，帮助组件只接受 fs.FS，并读取根下的相对名称。

这会改变组件看见的路径名称，不会复制一套资源，也不会把文件内容缓存起来。界面加载失败时，可以把“资源根选择错误”和“根下文件名称错误”分开处理，避免统一显示一个没有线索的空白面板。

建立视图后只传相对文件名

下面用内存文件系统展示完整调用关系。testing/fstest 只作为独立示例的数据来源；业务可以换成其他实现 fs.FS 的资源系统。示例未在本机运行。

package main

import (
    "fmt"
    "io/fs"
    "testing/fstest"
)

func showHelp(resources fs.FS) error {
    // 组件只知道自己的资源根，不拼接父目录前缀。
    text, err := fs.ReadFile(resources, "welcome.txt")
    if err != nil {
        return fmt.Errorf("读取帮助内容: %w", err)
    }
    fmt.Print(string(text))
    // 点号表示当前文件系统视图的根目录。
    entries, err := fs.ReadDir(resources, ".")
    if err != nil {
        return fmt.Errorf("列出帮助资源: %w", err)
    }
    for _, entry := range entries {
        fmt.Println(entry.Name())
    }
    return nil
}

func main() {
    // 内存文件仅用于演示目录映射，不需要创建真实文件。
    source := fstest.MapFS{
        "assets/docs/welcome.txt": &fstest.MapFile{Data: []byte("欢迎使用帮助中心\n")},
        "assets/docs/shortcuts.txt": &fstest.MapFile{Data: []byte("快捷键说明\n")},
        "assets/theme.txt": &fstest.MapFile{Data: []byte("主题配置\n")},
    }
    docs, err := fs.Sub(source, "assets/docs")
    if err != nil {
        fmt.Println("建立资源视图失败:", err)
        return
    }
    if err := showHelp(docs); err != nil {
        fmt.Println(err)
    }
}

按示例数据，帮助组件应读到欢迎文本，并在目录列表中取得 shortcuts.txt 与 welcome.txt。assets/theme.txt 不在该帮助视图的根目录下。若继续读取 assets/docs/welcome.txt，就会在已选子目录下重复叠加前缀，通常导致找不到文件。

把点号与目录前缀分清

io/fs 使用斜杠分隔的相对路径。不要给 Sub 传入操作系统绝对路径，也不要把目录名写成 assets/docs/。选择目录的字符串应该遵循 fs.ValidPath 的规则，点号是表示根目录的特殊合法形式。

创建成功还要处理后续读取错误

Sub 会检查目录路径形式，但它本身不保证目录此刻存在。默认包装实现可能直到 ReadFile 或 ReadDir 时才报告不存在。因此示例在创建、读取、列举三个位置分别处理错误，组件应保留明确失败状态，而不是把空内容当作正常帮助页。

若底层实现了 SubFS，fs.Sub 会委托它的 Sub 方法；否则提供路径前缀包装。调用者仍按 fs.FS 契约使用结果，不应依赖某个具体包装类型。

视图范围不能代替文件访问隔离

Sub 适合整理资源路径和组件依赖。对于 os.DirFS，目录中的符号链接可能指向根目录以外，给它再套 Sub 并不会变成 chroot 式安全机制。需要限制不可信磁盘访问时，应选择专门的访问约束方案；不要把路径前缀包装当成权限保证。

必须在每次读取前创建 Sub 吗？

不需要。可以在资源组装时创建视图，再传给组件复用。这样也便于统一决定目录约定。

子视图有 Close 方法吗？

fs.FS 接口本身没有 Close。若调用 Open 取得文件，应按文件接口关闭；示例使用 ReadFile 直接得到字节内容。

资源根换了会影响组件吗？

只要新根仍提供 welcome.txt 等相同相对名称，组件不必知道父级目录如何组织。这正是子视图帮助解耦的位置。

参考：Go fs.Sub 文档；Go 子视图实现说明。