gin应用打包为单个二进制文件需用go 1.16+ embed包嵌入templates/*/和static/资源，并通过template.parsefs和fs.sub正确加载；交叉编译须设cgo_enabled=0，docker多阶段构建应选用scratch或alpine基础镜像。
直接打包成单个二进制文件是 Gin 应用最轻量、最可靠的部署方式——它不依赖 Go 环境、不依赖外部模板或静态资源目录，只要操作系统兼容（Linux/Windows/macOS），扔过去就能跑。
为什么 go build 后运行会 panic 模板找不到？
因为 Gin 默认用 LoadHTMLGlob 或 LoadHTMLFiles 从磁盘读取 templates/**/*.html，而 go build 只编译 Go 源码，不打包 HTML、CSS、JS 这些非代码文件。
- 现象：
panic: html/template: pattern matches no files: `templates/**/*.html` - 根本原因：二进制运行时工作目录下没有
templates/目录，且 Go 没自动把它们塞进去 - 解决路径只有一条：用 Go 1.16+ 的
embed包显式声明哪些文件要打进二进制
embed.FS 怎么正确声明和加载模板？
必须满足两个硬性条件：嵌入路径是源码文件所在目录的子目录；//go:embed 指令写在变量声明前，且不能被注释掉。
-
//go:embed templates/*只能匹配templates/下一级文件，不递归；要支持子目录需写templates/**/* - 模板加载必须用
template.Must(template.New("").ParseFS(embedFs, "templates/**/*"))，不能用LoadHTMLGlob - 变量声明必须是包级（不能在函数内），类型为
embed.FS，否则编译器无法识别嵌入意图
静态文件（/static）怎么通过 http.FS 暴露？
不能直接传 embed.FS 给 router.StaticFS，因为它的路径前缀是根目录，而你嵌入的是 static/ 子目录——必须先用 fs.Sub 切出子树。
- 错误写法：
router.StaticFS("/static", http.FS(embedFs))→ 会尝试找/static/static/xxx - 正确写法：
fp, _ := fs.Sub(embedFs, "static"); router.StaticFS("/static", http.FS(fp)) - Favicon 需单独处理：Gin 不自动映射
/favicon.ico到static/，得手动挂一个GET路由并用http.FileServer服务
交叉编译和 Docker 构建时容易漏掉什么？
本地 go build 成功 ≠ 部署环境能跑。常见断点不在逻辑，而在资源路径和构建环境。
- CGO_ENABLED=0 必须加：否则二进制可能动态链接 libc，导致 Alpine 镜像里直接报
not found - Linux 交叉编译命令示例：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o mediabank . - Docker 多阶段构建中，第二阶段基础镜像必须是
scratch或alpine:latest，不能用golang:alpine（它带 Go 环境，浪费） - 如果用了
os.Getwd()或相对路径读配置，打包后会指向容器根目录，应改用os.Executable()推导二进制所在目录
真正卡住人的从来不是语法，而是 embed 路径声明与 fs.Sub 的配合时机、以及 CGO 和目标平台的隐式耦合——这些地方一旦出错，panic 信息里完全不提 embed，只会说“file not found”，得靠经验往回推。
