能实现单文件部署，但不是“静态化”工具，而是编译期资源固化——文件内容直接写进二进制只读段，运行时无I/O、无路径依赖，改资源必须重编译；嵌入单个文件用string或[]byte最快，路径须为相对.go文件的静态字面量，//go:embed必须紧邻变量声明且类型仅限[]byte、string或embed.FS，嵌入整个目录需用embed.FS+fs.Sub对齐请求路径，并用http.FS包装才能用于HTTP服务。
能实现单文件部署，但不是“静态化”工具，而是编译期资源固化 —— 文件内容直接写进二进制只读段，运行时无 I/O、无路径依赖，改资源必须重编译。
嵌入单个文件：用 string 或 []byte 最快，但路径必须字面量
适合配置、小图标、模板片段等固定内容。声明和使用必须严格对齐：
-
//go:embed指令必须紧邻变量声明，中间不能有空行或注释 - 变量类型只能是
[]byte、string或embed.FS，不能是*os.File或其他自定义类型 - 路径必须是相对当前
.go文件的静态字符串，比如"config.yaml"，不能是dir + "/config.yaml"或"./config.yaml" - 若文件在
internal/assets/下，而.go在cmd/app/，需把文件移到同包下，或改用embed.FS+ 显式子目录声明
嵌入整个前端目录：用 embed.FS + fs.Sub 控制挂载点
常见于 dist/ 或 web/static/ 目录。关键不是“怎么嵌”，而是“怎么让请求路径和嵌入路径对上”：
-
//go:embed web/dist/**才能递归包含子目录；web/dist/*只匹配一级文件 - 嵌入后，
web/dist/index.html在 FS 中的路径就是web/dist/index.html，不是index.html - 想让
/static/main.js访问到web/dist/main.js，必须先fs.Sub(fsys, "web/dist")切出子树，再http.FS()包装 - 漏掉
http.StripPrefix("/static/", )会导致请求路径多了一层前缀，查不到文件 - 错误写法（直接传
embed.FS）会编译失败：cannot use fsys (type embed.FS) as type http.FileSystem
embed.FS 读取失败总是 fs.ErrNotExist，别用 os.IsNotExist
这是最常被忽略的类型差异。嵌入文件不存在时，embed.FS.ReadFile 返回的是 *fs.PathError，其底层 error 是 fs.ErrNotExist：
立即学习“go语言免费学习笔记（深入）”；
- ✅ 正确判断：
if errors.Is(err, fs.ErrNotExist) - ❌ 错误判断：
os.IsNotExist(err)—— 对 embed 返回false，永远走不到分支 - Windows 上大小写不敏感，但 embed 路径区分大小写，
Logo.png ≠ logo.png - 调试建议：用
fs.ReadDir(fsys, ".")打印根目录结构，确认实际嵌入了哪些路径
HTTP 服务中嵌入资源：必须过 http.FS，且 MIME 类型要自己管
http.FileServer 默认逻辑（如自动加 Content-Type）在 embed 下不完全生效：
- 别用
http.Dir("./assets")，那是读磁盘路径；必须用http.FileServer(http.FS(yourEmbedFS)) - 如果静态资源需支持 SPA 路由（如 React/Vue），要配合
http.StripPrefix和 fallback handler，否则刷新 404 -
embed.FS是只读的，所有文件在编译时固化，修改资源必须重新编译二进制 - 大文件（如视频、PDF）慎
embed—— 会直接增大二进制体积，且无法按需加载
真正容易被忽略的点是路径对齐和错误判断方式：嵌入路径是相对于 .go 文件所在目录的静态字面量，不是项目根；fs.ErrNotExist 不能用 os.IsNotExist 判断 —— 这两个细节一错，就卡在“文件明明存在却读不到”。
