Go 1.16+ 用 embed 包可将文件编译进二进制，但需满足路径为相对包根的字面量、包与变量声明正确三重约束；embed.FS 要求路径不可拼接、不可跨模块、不支持 ./ 前缀；读取需用 fs.ErrNotExist 判断缺失；HTTP 服务中可直接用 http.FileServer(http.FS(fs))；嵌入在构建时完成，不支持热重载或动态路径。
Go 1.16+ 直接用 embed 包就能把文件编译进二进制，不需要额外工具或构建脚本——但必须满足路径、包声明、变量声明三重约束，否则 go build 会静默忽略或报错。
embed.FS 要求文件路径是相对包根的字面量
不能拼接字符串、不能用变量、不能跨模块引用。比如你的 Go 文件在 cmd/myapp/main.go，想嵌入 assets/logo.png，就必须写成：
//go:embed assets/logo.png var logoFS embed.FS
如果写成 //go:embed assets/*，那 assets/ 必须和当前 .go 文件在同一模块下，且该目录不能是空的（否则 embed 会跳过）。
- 路径必须是单引号或双引号内的纯字符串，不支持通配符展开失败时无提示
- 不能写
//go:embed ./assets/logo.png——./前缀会被拒绝 - 如果文件在外部 git submodule 或
vendor/下，embed 默认不可见，得靠-mod=mod或调整模块结构
embed.FS 读取文件要处理 io/fs.PathError
embed.FS 是 io/fs.FS 的实现，fs.ReadFile 或 f.Open() 失败时返回的是 *fs.PathError，不是 os.IsNotExist 那套旧逻辑：
立即学习“go语言免费学习笔记（深入）”；
data, err := fs.ReadFile(logoFS, "assets/logo.png")
if errors.Is(err, fs.ErrNotExist) {
// 正确：用 fs.ErrNotExist 判断缺失
}- 别用
os.IsNotExist(err)，它对 embed 返回 false - 嵌入路径区分大小写，Windows 上容易因大小写不一致导致
fs.ErrNotExist - 如果用了
//go:embed assets/**，子目录里的文件路径必须带前缀，比如assets/css/style.css
HTTP 服务中直接用 http.FileServer + embed.FS
不用转成 http.FileSystem 实现，Go 1.16+ 的 http.FileServer 已原生支持 embed.FS：
//go:embed frontend/*
var frontendFS embed.FS
<p>func main() {
http.Handle("/", http.FileServer(http.FS(frontendFS)))
http.ListenAndServe(":8080", nil)
}- 注意：
http.FS()是转换函数，不是类型；传错类型（比如直接传frontendFS）会编译失败 - 默认不支持目录列表，访问
/返回 404 是正常的；加http.StripPrefix和http.ServeFile才能控制行为 - 嵌入大量小文件时，
embed.FS在内存里是只读结构，无额外 GC 开销，但初始加载略慢
最常被忽略的是：嵌入操作发生在 go build 阶段，不是运行时；修改文件后必须重新 build，热重载无效。另外，embed 不支持动态路径或条件嵌入——想按环境打包不同资源，得用构建 tag 分离文件或生成代码。
