//go:embed 路径必须严格相对于 go.mod 所在目录，禁止使用 ..；大小写需与文件系统一致；http.FileServer 需用 http.StripPrefix 对齐 URL 与嵌入路径；template.ParseFS 应用 ** 递归匹配。
Go 1.16+ 的 //go:embed 在多平台构建中完全可靠，但路径必须严格对齐模块根目录，且不能含 ..；否则跨平台编译（如 macOS → Linux）会静默失败或运行时报 file does not exist。
//go:embed 路径必须从 go.mod 所在目录算起
embed 不认当前工作目录、不认 main.go 位置、也不认构建命令执行路径。它只以 go.mod 文件所在目录为“根”，所有路径都是相对于它的。
- 错误示例：
go.mod在项目根，资源在assets/，但你在cmd/server/main.go里写//go:embed ../assets/*→ 编译直接报invalid pattern: must not contain ".." - 正确写法：统一放资源到
assets/（与go.mod同级），然后在任意.go文件中写//go:embed assets/** - 调试建议：在代码里加
fs.ReadDir(staticFS, ".")打印顶层结构，确认assets/是否出现在输出中
文件名大小写敏感导致跨平台 404
macOS 和 Windows 默认文件系统不区分大小写，Linux 则严格区分。embed 把路径字面量固化进二进制，不会做 OS 层标准化。
- 现象：本地开发时
fs.ReadFile("Assets/logo.png")能成功，部署到 Linux 就 panicfile does not exist - 根本原因：实际文件是
assets/logo.png，但读取路径用了大写Assets - 解决办法：所有嵌入路径和读取路径统一用小写 + 连字符，例如
static/css/main.css；CI 中可加测试断言fs.Open("static/css/main.css") == nil
http.FileServer 服务嵌入资源必须三步对齐
嵌入成功 ≠ 浏览器能访问。URL 路径、FS 内部路径、http.StripPrefix 剥离逻辑三者必须严丝合缝，否则 404。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 假设你
//go:embed ui/**，那么ui/index.html在 FS 中的真实路径就是ui/index.html - 若想通过
/static/index.html访问，必须：http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.FS(uiFS)))) - 漏掉
http.StripPrefix：请求/static/index.html会传index.html给 FS，找不到 → 404 - 错用
http.Dir("./ui")替代：那是读磁盘，不是 embed，跨平台时路径又可能错乱
template.ParseFS 的 glob 模式容易漏文件
template.ParseFS 的模式匹配是基于 embed 后的虚拟路径结构，不是原始磁盘结构；单星号 * 不递归，双星号 ** 才能覆盖子目录。
- 写
//go:embed ui/**后，ui/pages/home.html的真实路径是ui/pages/home.html - 用
template.ParseFS(tmplFS, "ui/*.html")只能匹配ui/下一级，pages/里的模板全被忽略 - 正确写法：
template.ParseFS(tmplFS, "ui/**/*.html")（注意双星号） - 更稳妥的做法：不用
ParseFS，改用fs.ReadFile(tmplFS, "ui/pages/home.html")+template.Must(template.New("").Parse(...))
最常被忽略的是路径对齐点：不是“代码在哪”，而是“go.mod 在哪”；不是“我想怎么叫”，而是“文件系统里它真叫什么”。跨平台构建时，这点差一个斜杠或一个大小写，就彻底断开。
