Go 1.16+ 必须用 embed.FS 配合 //go:embed，路径需相对于 .go 文件、大小写敏感、忽略点线文件、空目录不嵌入；fs.ReadFile 路径须与 embed 声明严格一致；http.FileServer 需 http.FS 包装并配合 fs.Sub 和自定义 handler 支持 SPA。
Go 1.16+ 必须用 embed.FS 配合 //go:embed 指令，才能把 HTML/JS/CSS 打包进单个二进制文件；其他方式（如 packr、statik）已不维护，且引入额外构建步骤和失败风险。
为什么 //go:embed assets/** 总是没文件？
根本不是通配符写错，而是路径解析规则被忽略：
-
//go:embed的路径是相对于当前.go文件所在目录，不是项目根或go build执行目录 - 不支持
./或../—— 写./assets/*直接编译失败，必须写assets/* - 大小写敏感：Linux/macOS 下
Assets/和assets/是两个路径，Windows 上磁盘可能不报错，但 embed 会静默跳过 - 以
.或_开头的文件（如.env、_redirects）默认被忽略，前端 SPA 的.nojekyll就会丢 - 空目录不会被嵌入 —— 即使写了
assets/css/，若该目录下无任何可读文件，就什么都不会进二进制
fs.ReadFile 报 no such file or directory 怎么办？
这不是磁盘路径问题，是你把 embed.FS 当成了本地路径前缀：
- 错误写法：
os.ReadFile("assets/index.html")→ 运行时报错，因为文件不在磁盘上 - 正确写法：
fs.ReadFile(assets, "assets/index.html")，路径必须和//go:embed声明完全对齐 - 如果写的是
//go:embed ui/*，就读ui/main.css，不能漏掉ui/前缀 - 多次读同一文件别反复调
fs.ReadFile—— 它每次分配新内存，建议缓存或提前解析成template.Templates
http.FileServer 返回 404 或无法 fallback 到 index.html？
直接传 embed.FS 给 http.FileServer 会因接口不兼容或路径越界挂掉：
立即学习“go语言免费学习笔记（深入）”；
-
embed.FS不实现http.FileSystem，必须用http.FS(assets)包一层 - 若嵌入的是
dist/目录，但想让/请求映射到dist/下内容，得先fs.Sub(assets, "dist")切子树，再http.FS(...) -
http.StripPrefix("/static", http.FileServer(...))只做路径裁剪，不做 fallback —— SPA 路由（如/user/profile）仍会 404 - 真要支持 SPA，得手写 handler：先
fs.Open(path)尝试读，err != nil时兜底http.ServeFile(w, r, "dist/index.html")，并显式设Content-Type: text/html; charset=utf-8
最容易被忽略的是开发与生产路径一致性：嵌入路径写死在代码里，但前端构建产物（如 dist/）位置可能随 vite.config.ts 或 vue.config.js 变动；build 后没清空旧 dist/，残留文件会被悄悄 embed 进去。上线前务必用 fs.ReadDir 打印嵌入结构验证。
