Go 1.16正式引入了io/fs包和embed功能，将文件系统抽象为fs.FS接口，极大提升了代码的可测试性和可移植性。然而，这一抽象也带来了一些令人头疼的问题。近日，有开发者在Stack Overflow上提问：“I have an fs.FS, and use WalkDir. How can I get the ‘real’ full path to an entry it finds?” 这揭示了虚拟文件系统与操作系统真实路径之间的鸿沟，是许多Go开发者在实际项目中都会遇到的痛点。

WalkDir的“路径”到底是什么？

fs.WalkDir函数的签名是：

func WalkDir(fsys fs.FS, root string, fn fs.WalkDirFunc) error

回调函数fn接收的参数之一path，是一个以root为基准的相对路径。例如，如果你对os.DirFS("/home/user/project")调用WalkDir，那么遍历到main.go文件时，path的值是"main.go"或"subdir/main.go"，而不是"/home/user/project/main.go"。

这种设计符合fs.FS的抽象本质——它不关心底层存储是操作系统目录、ZIP压缩包，还是编译时嵌入的静态文件。然而，当开发者确实需要操作系统的绝对路径（例如为了调用os.Open、os.Stat，或者传递给外部程序）时，问题就出现了。

不同fs.FS实现的不同解法

1. 使用os.DirFS：最接近真实路径的情况

如果你是通过os.DirFS(baseDir)创建的fs.FS，那么每个entry的“真实”路径就是 filepath.Join(baseDir, path)。但要注意：os.DirFS返回的文件系统是只读的，而且无法直接通过path获取绝对路径。正确做法是：

base := "/home/user/project"
fsys := os.DirFS(base)
fs.WalkDir(fsys, ".", func(path string, d fs.DirEntry, err error) error {
    realPath := filepath.Join(base, path)
    // realPath 即操作系统绝对路径
    return nil
})

这里的关键是将基础路径提前保存，然后在回调中拼接。如果base是相对路径，建议先用filepath.Abs转换为绝对路径。

2. 使用embed.FS：根本不存在“真实路径”

embed.FS是在编译时嵌入Go二进制文件中的静态文件系统，没有对应的操作系统文件。当你通过//go:embed指令嵌入一个目录时，这些文件在运行时的唯一存在形式就是内存中的字节数组。试图获取它们的真实路径是徒劳的——因为你无法通过操作系统路径访问它们。

官方文档明确说明：embed.FS满足fs.FS接口，但其Open方法返回的fs.File不提供*os.File的方法，也不支持Path()方法。如果你需要获取嵌入文件的“位置”，通常是为每个文件手动记录元数据，或者改用os.DirFS。

最佳实践：如果项目同时需要开发时的文件访问和部署后的嵌入，可以设计一个配置选项，让使用者选择是否启用embed。更多时候，直接使用os.DirFS配合构建标签（build tags）实现开发/生产环境的切换。

3. 自定义fs.FS：需要你自己实现路径追踪

如果你实现了自己的fs.FS（例如基于S3、数据库等），那么你完全掌控路径映射逻辑。可以在Open方法返回的文件对象中嵌入原始路径信息，或者在WalkDir时直接将内部路径作为path返回（此时path就是“真实”路径）。但为了严格遵循fs.FS接口，建议将完整路径作为元数据附加到fs.File的某个字段中，或者使用闭包捕获上下文。

通用解决方案：放弃“真实路径”思维

对于大部分应用场景，你并不需要真正的操作系统路径。io/fs包提供了ReadFile、Stat、ReadDir等所有读取操作，完全可以在不离开抽象层的前提下完成文件处理。例如，遍历时可以直接调用fs.ReadFile(fsys, path)读取文件内容，无需先转换为真实路径。

只有当必须调用第三方库（如os/exec、crypto/tls等需要文件路径的API）时，才需要考虑路径转换。此时，最安全的做法是：

  • 如果使用os.DirFS，用基础路径拼接；
  • 如果使用embed.FS，将文件内容写入临时文件，然后使用临时路径；
  • 如果使用其他自定义FS，确保实现了某种“路径解析”方法。

总结

fs.FS的抽象让Go的文件操作更加灵活，但也让“获取真实路径”这个原本简单的需求变得复杂。核心原则是：不要依赖真实路径，尽量在抽象层内完成所有操作。如果实在需要，请根据fs.FS的具体实现类型选择对应策略——用os.DirFS时拼接，用embed.FS时放弃，用自定义FS时自行设计。

随着Go社区对io/fs的接受度越来越高，类似的问题会频繁出现。建议开发者在设计API时，优先传递fs.FS和相对路径，而非绝对路径，从而保持与抽象文件系统的兼容性。