Go 1.16+唯一官方推荐方式是//go:embed，必须紧邻embed.FS或[]byte/string变量声明，路径须相对于.go文件、禁用..、Windows用/、多级目录需双星号，且需http.FS()桥接和fs.Sub()对齐路径。
Go 1.16+ 必须用 //go:embed，其他方案（packr、statik、go-bindata）已过时或需额外维护，且无法规避路径映射、MIME 类型、SPA fallback 等核心问题。
怎么写对 //go:embed 指令和变量声明
编译期报错 pattern matches no files 多数是因为路径或语法不合规：
-
//go:embed必须紧挨着embed.FS或[]byte/string变量声明，中间不能有空行、注释或其它语句 - 路径是相对于当前
.go文件的，不支持..向上跳转；Windows 下也必须用/（不是\） - 嵌入目录时，通配符只匹配一级：
//go:embed assets/*不会包含assets/js/app.js，得显式加//go:embed assets/**（双星号才递归） - 变量名本身无关紧要，但类型必须是
embed.FS（多文件）或基础类型（单文件），不能是自定义别名类型
为什么 http.FileServer(http.FS(staticFS)) 直接挂根路径会 404
嵌入路径结构会完整保留。比如 //go:embed dist/*，那么 dist/index.html 在 FS 中的真实路径就是 "dist/index.html"，不是 "index.html"。
- 错误写法：
http.Handle("/", http.FileServer(http.FS(staticFS)))→ 浏览器访问/时，FS 尝试打开""（空路径），失败 - 正确做法：用
fs.Sub(staticFS, "dist")剥离前缀，再传给http.FileServer，这样"/"对应的就是dist/下的index.html - 若不想用
fs.Sub，也可在//go:embed里直接指定子目录内容，例如//go:embed dist/index.html dist/static/**，但维护成本高
Vue/React 等 SPA 怎么让前端路由不 404
http.FileServer 本身不处理 history 模式下的路径 fallback，必须自己拦截未命中请求并返回 index.html。
立即学习“go语言免费学习笔记（深入）”；
- 不能用
http.NotFoundHandler全局兜底——它无法区分真实 404 和合法前端路由（如/dashboard） - 推荐闭包 handler：先
staticFS.Open(path)尝试读取；失败且路径不含.（即无扩展名），就http.ServeFile(w, r, "dist/index.html") - 注意
fs.ReadFile和fs.Open行为不同：Open能触发Stat()判断是否存在，ReadFile直接 panic，不适合做存在性判断 - 构建 Vue 时，
vue.config.js的publicPath必须设为"./"或与 Go 服务路径一致（如 Go 服务跑在/app/，则publicPath: "/app/"）
二进制体积大、部署后 MIME 类型错怎么办
嵌入资源后，HTTP 响应头 Content-Type 由 http.FS 实现根据文件名后缀推断，但嵌入时没有真实文件系统，依赖 fs.FileInfo.Name() 返回的字符串是否含正确后缀。
- 确保嵌入路径保留原始文件名和后缀，例如
assets/logo.png，不能写成logo或logo.bin - 图片/字体等大文件会让二进制显著膨胀，可选
upx --best myapp压缩，但 macOS Apple Silicon 上可能破坏签名，CI 构建前需验证 - 调试嵌入内容是否完整？用
fs.WalkDir(staticFS, ".", func(path string, d fs.DirEntry, err error) {...})打印所有路径，确认结构符合预期 - 不要嵌入
node_modules、.git、vite.svg等非交付文件——它们不会被引用，只会拖慢编译、增大体积
最容易被忽略的是：嵌入路径与运行时 Open 路径必须完全一致，大小写敏感，且 fs.Sub 或 http.StripPrefix 的层级必须和嵌入结构严格对齐；任何一处脱节，都会变成静默 404 或 MIME 错误，而不是编译失败。
