go 1.16+ embed 嵌入资源无法用 os.open 读取，因未落地磁盘；须用 embed.fs 的 readfile 或 open 方法，并通过构造函数注入 mock 实现统一测试与生产行为。
Go 1.16+ embed 嵌入后无法用 os.Open 读取
嵌入的静态资源不是真实文件系统路径，os.Open("assets/config.json") 必然报 no such file or directory。这不是路径写错，是根本没落地到磁盘。
正确做法是直接用 embed.FS 提供的 ReadFile 或 Open 方法：
var assets embed.FS
func LoadConfig() ([]byte, error) {
return assets.ReadFile("assets/config.json")
}
测试时若想 Mock 这个行为，不能 Mock os.Open —— 它压根没被调用。
- 真正被调用的是
assets.ReadFile，它返回[]byte和error - 如果业务逻辑强依赖
io.ReadCloser（比如传给json.NewDecoder），需用bytes.NewReader包一层 - 别试图把
embed.FS当成接口去替换——它没有导出接口类型，Go 标准库里就是具体 struct
测试中如何安全替换 embed.FS 行为
Go 的 embed.FS 是不可变值，无法在运行时修改。唯一可控点是你自己定义的变量或字段，比如：
立即学习“go语言免费学习笔记（深入）”；
var Assets embed.FS // 全局变量，用于生产环境
// 或
type Service struct {
fs embed.FS
}
测试时通过包级变量赋值或构造函数注入来切换：
- 包级变量：在
test文件里用init()或TestMain替换Assets = testFS，但要小心并发和重置问题 - 更推荐构造函数注入：
NewService(embed.FS)，测试时传入自定义testFS实现 -
testFS不必实现完整fs.FS——只实现Open和ReadFile即可，其他方法 panic 或返回fs.ErrNotExist
示例最小 mock：
type testFS map[string][]byte
func (t testFS) Open(name string) (fs.File, error) {
data, ok := t[name]
if !ok {
return nil, fs.ErrNotExist
}
return fs.File(bytes.NewReader(data)), nil
}
func (t testFS) ReadFile(name string) ([]byte, error) {
data, ok := t[name]
if !ok {
return nil, fs.ErrNotExist
}
return data, nil
}
为什么不用 ioutil.ReadFile 或 os.ReadFile 配合 -tags 条件编译
有人想“开发时读磁盘，构建时嵌入”，靠 //go:build embed 切换读取方式。这看似灵活，实际埋雷：
- 测试环境行为不一致：单元测试走磁盘路径，CI 构建走 embed，容易漏掉路径拼错、权限、大小写等错误
-
os.ReadFile在 Windows/macOS 大小写不敏感，Linux 敏感，而embed.FS严格区分大小写——本地测过，上线就file not found - 条件编译增加维护成本，且无法覆盖“嵌入后路径变更”这类逻辑 bug
真实项目中，越早统一使用 embed.FS 接口，越少踩跨平台和构建差异的坑。
Mock embed.FS 时最容易忽略的细节
不是所有嵌入路径都等价。比如你写 //go:embed assets/**，实际嵌入的 key 是 "assets/config.json"，但如果你在代码里写 assets.ReadFile("config.json")，就会失败。
- 嵌入路径前缀必须和
ReadFile参数完全一致（包括开头斜杠、相对位置） - 用
embed.FS的ReadDir查看实际键名：entries, _ := assets.ReadDir(".")，打印e.Name() - Mock 的
testFS键名也得对齐，否则测试通过、线上失败 - 如果嵌入了空目录（如
assets/empty/），embed.FS会包含该目录条目；但你的 mock 若没预置，ReadDir("assets")就可能少一项
路径匹配这事，不打印出来看一眼，十有八九栽在看不见的斜杠和大小写上。
