go 1.16+ 应优先使用 embed 包嵌入静态资源，因其为标准库、零依赖、编译期校验路径，而旧版本需借助 go-bindata 等第三方工具；embed 要求 //go:embed 注释紧邻变量声明、路径相对当前 .go 文件、禁止向上跳级（如 ..），且大小写敏感、仅支持 和 * 通配符。
Go 1.16+ 直接用 go:embed，不用额外装工具；低于这个版本才需要 go-bindata 或 statik 这类第三方方案。
确认 Go 版本再决定用哪个打包方式
运行 go version 看输出。如果显示 go1.16 或更高（比如 go1.22.0），embed 就可用；如果卡在 go1.15 或更早，就得走生成代码的老路。
-
go:embed是标准库，零依赖、无构建步骤、路径写错编译期就报错 -
go-bindata需要go get安装，每次改资源都得重新运行命令生成.go文件 - 旧项目若已用
packr，注意它已归档不再维护，packr2对中文路径和空格处理不稳定
go:embed 的写法和常见翻车点
必须严格满足三件事：变量声明紧挨着 //go:embed 注释、路径相对于当前 .go 文件、不能用 .. 向上跳级。
- 正确写法：
//go:embed assets/* var assets embed.FS
—— 中间不能有空行或注释 - 路径大小写敏感：Linux/macOS 下
Assets/和assets/是两个目录 - Windows 也得用
/，不是\；//go:embed assets\img会静默失败 - 通配符只支持
**（递归）和*（单层），不支持?.js这类 shell 模式
HTTP 服务中用 embed.FS 提供静态文件
直接套 http.FileServer 时，MIME 类型靠文件后缀推断，所以嵌入路径必须保留原始扩展名（比如 style.css，不能写成 assets/css）。
- 别写
http.FileServer(http.FS(assets))就完事——它默认把根路径映射到/，容易暴露不该暴露的文件 - 推荐加一层
http.StripPrefix：http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.FS(assets)))) - 如果用了 Gin，要用
gin.StaticFS("/static", http.FS(assets))，不是gin.Static() - 调试路径是否真嵌进去了？用
fs.WalkDir(assets, ".", ...)打印所有嵌入路径
二进制体积变大怎么办
嵌入大量图片、字体或未压缩的 JS/CSS 会让最终可执行文件明显膨胀，但这是为部署简化付出的合理代价。
- UPX 可压缩二进制，命令：
upx -o myapp-compressed myapp - macOS Apple Silicon 上 UPX 压缩后的文件可能无法签名，CI 构建前先确认是否启用代码签名
- 嵌入的资源运行时不可写，所有修改都在内存副本里，重启即丢——这不是 bug，是设计如此
- 如果真需要动态更新资源，说明不适合用
embed，该回归文件系统或对象存储
真正容易被忽略的是路径作用域和大小写一致性——//go:embed 的路径是相对于 .go 文件所在目录的，不是项目根目录，也不是 go run 执行时的当前工作目录。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
