根本原因是运行时路径依赖当前工作目录（pwd），而非源码或二进制位置；os.Open、http.Dir、template.ParseFiles均以pwd为基准解析相对路径，切换目录即导致路径失效、404。
Go 二进制运行时找不到静态资源，根本原因不是“编译漏了”，而是运行时路径和资源定位方式没对齐——os.Open、http.Dir、template.ParseFiles 这些函数都依赖当前工作目录（pwd），而 Go 二进制本身不记录源码位置。
为什么 http.Dir("./static") 在别处运行就 404
你本地 go run main.go 或在项目根目录执行 ./myapp 时一切正常，是因为 ./static 指向了真实存在的目录；但一旦切换到 /usr/bin 或容器里执行，pwd 变了，./static 就指向一个空目录或根本不存在的路径。
-
http.Dir是运行时读磁盘，不是编译期打包，它和go build无关 - Windows 下手写
"static\css"会静默失败——Go 只认/，反斜杠被忽略 - 没加
http.StripPrefix会导致请求路径多了一层前缀，比如/static/app.js去查./static/static/app.js
//go:embed 路径总报 “pattern matches no files” 怎么办
这不是文件不存在，是嵌入路径基准错了：//go:embed 的路径始终相对于声明它的 .go 文件所在目录，不是项目根、不是 main.go 位置、也不是 go build 当前目录。
- 把
//go:embed static/*写在cmd/server/main.go里 → 编译器实际找的是cmd/server/static/ - 资源真在项目根
static/，就得把 embed 声明挪到根目录的embed.go里，再写//go:embed static/** - 用
fs.ReadDir(staticFS, ".")打印顶层结构，确认哪些路径实际被嵌进去了 - 空目录、
.git、_config.yml、大小写不一致（如Logo.pngvslogo.png）都会被静默跳过
http.FileServer 接 embed.FS 编译不过
因为 embed.FS 实现的是 fs.FS 接口，而 http.FileServer 需要 http.FileSystem 类型——两者不兼容，必须桥接。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 直接写
http.FileServer(staticFS)会编译报错：cannot use staticFS (type embed.FS) as type http.FileSystem - 正确写法是
http.FileServer(http.FS(staticFS)) - 如果嵌入的是
ui/目录，但想挂载到/static/，得组合：http.FileServer(http.FS(fs.Sub(staticFS, "ui")))，再套一层http.StripPrefix("/static/", ...) - 漏掉
http.StripPrefix，请求/static/app.js就会去查app.js（没带前缀），必然 404
Gin 的 r.Static 和 r.StaticFS 容易踩的坑
Gin 的静态路由封装了 http.FileServer，但参数顺序和路径映射逻辑极易出错。
-
r.Static("/static", "./dist/static")是对的；r.Static("./dist/static", "/static")会 panic 或静默失效 -
r.StaticFS("/assets", http.FS(staticFS))中，/assets是 URL 前缀，staticFS里必须有dist/static/...这样的相对路径结构，不能多一层static - SPA 应用必须用
r.NoRoute()做 fallback，且必须放在所有r.GET("/api/")之后，否则 API 请求全被当成静态资源拦截 - HTML 中引用必须用绝对路径：
<link href="/static/css/app.css">，不能写../css/app.css或css/app.css
最常被忽略的一点：embed 路径是编译期字面量，不能拼接变量、不能用 ../、不能含 ./；而运行时路径（如 os.Executable() 推导出的路径）在 UPX 压缩或容器符号链接下可能不可靠——生产环境建议 embed + 命令行参数双保险。
