embed 能打包静态资源，但路径须静态、大小写敏感、不可跨目录，且 embed.FS 必须经 http.FS 包装才能用于 http.FileServer；嵌入声明需紧贴变量，路径为字面量，支持 assets/ 和 assets/*，不支持 .. 或字符串拼接。
直接说结论：embed 能打包静态资源，但路径必须静态、大小写敏感、不能跨目录，且 embed.FS 不能直接喂给 http.FileServer——不包装就编译报错。
嵌入声明必须紧贴变量，且路径是字面量
常见错误是加了空行、用了./assets或拼接字符串。//go:embed 是编译期指令，只认紧挨着的包级变量，中间不能有空行或注释。
-
//go:embed assets/*✅ 正确：匹配当前包下assets/目录内所有一级文件（不含子目录） -
//go:embed assets/**✅ 正确：递归匹配子目录（Go 1.16+ 支持） -
//go:embed ../config.yaml❌ 编译失败：不支持..向上跳转 -
//go:embed "assets/" + env❌ 编译失败：不能用变量、函数或字符串拼接 - 路径区分大小写：macOS 上
fs.ReadFile("Assets/logo.png")可能“碰巧”成功，Linux 构建会 panic
读取路径是虚拟的，不是磁盘路径
你声明 //go:embed static/*，那 static/ 就是 embed 的根；后续调用 fs.ReadFile("logo.png") 才对，而不是 "static/logo.png"——除非你显式保留前缀。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 想保留层级？写
//go:embed static/**，再读fs.ReadFile("static/logo.png") - 想扁平化？写
//go:embed static/*，再读fs.ReadFile("logo.png") - 嵌入空目录或以
.、_开头的文件（如.gitignore）会被忽略，不会报错但也不可用 - 调试建议：在 main 里加
fs.ReadDir(staticFiles, ".")打印实际结构，别猜
http.FileServer 需要 http.FS 包装
embed.FS 不实现 http.FileSystem 接口，直接传给 http.FileServer 会编译失败：cannot use fs (type embed.FS) as type http.FileSystem。
- 必须用
http.FS(staticFiles)包一层，再传进去 - 如果嵌入的是
web/dist，又希望/直接返回 index.html，得先fs.Sub(embeddedFiles, "web/dist")切出子树 - 挂载路径注意前缀对齐：比如
http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.FS(staticFiles))))，否则请求/static/css/main.css会去读css/main.css而不是static/css/main.css - SPA 场景（如 React Router）需 fallback handler，否则刷新页面 404
大文件和测试验证容易被忽略
嵌入 10MB 图片会让二进制体积暴涨，且无法按需加载；更隐蔽的问题是——你根本不确定它真被打包进去了，尤其 CI 环境没源文件可 fallback。
- 大文件（>1MB）建议外部加载 + fallback：
os.ReadFile失败后再用fs.ReadFile - 测试时别硬编码路径，用
runtime/debug.ReadBuildInfo()查Settings里有没有embed相关字段 - 两个相同文件分别嵌入两次，二进制里就存两份——embed 不去重、不压缩
- 真正上线前跑一次构建信息检查，比靠本地开发“看起来能跑”靠谱得多
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
