Go os.DirFS 怎样把目录暴露为相对路径文件系统

Go 中调用 os.DirFS(dir)，可以把磁盘目录适配为 fs.FS。例如资源根是 /srv/notice-resources，组件读取 notices/start.txt 时，就会访问该根下的同名文件。目录参数使用操作系统路径，组件内部使用相对于文件系统根的名称。

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

接口目标：让组件接受 fs.FS

通知组件的需求很小：拿到一份文本并呈现给上层。若函数同时接收磁盘根目录、子目录和文件名，调用方就必须反复处理路径拼接。改为接收 fs.FS 后，部署代码负责选择磁盘根，组件只负责一个约定好的资源名称。

本例把读取函数命名为 readNotice。它依赖 resources 与 fs.ReadFile，不依赖具体部署目录；返回字节与错误，由上层决定输出方式。os.DirFS 负责目录适配，不复制资源，也不会自动把磁盘文件嵌入可执行文件。

参数选择：系统根路径与资源名称分开

DirFS 的 dir 不能是空字符串。用相对目录创建适配器时，后续 Chdir 会影响根的解析；示例在启动时转换为绝对路径，固定这次配置解析的基准。转换为绝对路径不等于打开目录，也不保证目录存在或可读。

完整程序：在启动处创建适配器

在准备好的资源根下创建 notices 子目录，并放置 start.txt。下面是完整程序，默认选择工作目录中的 resources，也可以通过 root 参数指定已有目录。代码未在本机执行。

package main

import (
    "errors"
    "flag"
    "fmt"
    "io/fs"
    "os"
    "path/filepath"
)

func readNotice(resources fs.FS) ([]byte, error) {
    // 组件名称相对于资源根，使用斜杠，不重复添加根目录。
    data, err := fs.ReadFile(resources, "notices/start.txt")
    if err != nil {
        return nil, fmt.Errorf("读取通知文件: %w", err)
    }
    return data, nil
}

func main() {
    root := flag.String("root", "resources", "资源根目录")
    flag.Parse()
    // 空参数是配置错误，在创建适配器前明确处理。
    if *root == "" {
        fmt.Fprintln(os.Stderr, "资源根目录不能为空")
        return
    }
    absoluteRoot, err := filepath.Abs(*root)
    if err != nil {
        fmt.Fprintln(os.Stderr, "解析资源目录失败:", err)
        return
    }
    // 使用绝对根减少后续工作目录变化的影响，不表示安全隔离。
    resources := os.DirFS(absoluteRoot)
    data, err := readNotice(resources)
    if err != nil {
        switch {
        case errors.Is(err, fs.ErrNotExist):
            fmt.Fprintln(os.Stderr, "通知文件不存在，请检查部署内容")
        case errors.Is(err, fs.ErrPermission):
            fmt.Fprintln(os.Stderr, "没有读取通知的权限")
        default:
            fmt.Fprintln(os.Stderr, err)
        }
        return
    }
    fmt.Print(string(data))
}

资源存在且可读时，程序应输出文件内容；未部署文件时，应输出相应错误提示。组件读取时不要再加 resources 或绝对根前缀，否则它会寻找错误的根下名称。

错误模型：把底层原因保留下来

DirFS 返回一个适配器，没有单独的错误返回值。真正的存在性、权限与读失败需要在访问时处理。readNotice 使用 %w 包装错误，让调用者继续通过 errors.Is 判断不存在或权限错误，同时保留“读取通知文件”这一业务上下文。

兼容策略：只把目录适配当作资源接口

将同一个组件接到其他 fs.FS 实现时，应保持 notices/start.txt 这样的逻辑名称不变；根目录映射由组装层决定。只要这个契约稳定，部署位置就不必进入组件代码。

DirFS 会遵循操作系统对符号链接的访问行为，链接可能指向所选树以外。因此它不能替代 chroot 式隔离。官方文档建议需要防止符号链接逃出目录树的场景使用 Root.FS 等专门接口，不能把绝对路径转换当成访问隔离措施。

能用 filepath.Join 构造组件名称吗？

系统路径和 fs.FS 名称应分开。跨平台组件名称保持斜杠格式，避免把系统分隔符直接带入文件系统接口。

DirFS 对象需要关闭吗？

fs.FS 本身没有 Close 方法。手动 Open 得到的文件需要关闭；本例使用 ReadFile 返回内容字节。

换部署目录时要改 readNotice 吗？

不需要，只需改变启动参数并保持根下资源布局。这也是把适配器放在启动位置的原因。

参考：Go DirFS 文档；Go 文件接口实现。