go:embed 是编译期硬编码机制，路径必须相对于 .go 文件目录、仅用正斜杠、禁止上下跳转、大小写敏感；空目录或隐藏文件被跳过；embed.fs 需经 http.fs() 转换并配合 stripprefix 使用；模板须用 fs.readfile 读取；路径必须为字面量且与声明严格一致。
go:embed 不是运行时加载机制，而是编译期硬编码——写错路径、类型不匹配、漏掉桥接，三者任一出问题，不是编译失败就是运行时 panic。
路径必须相对于 .go 文件目录，不是项目根
你写了 //go:embed assets/*，但 main.go 在 cmd/myapp/ 下 → embed 实际查找的是 cmd/myapp/assets/，而真实资源在项目根 → 报 pattern matches no files 且静默失败。
- Windows 下写
assets\*.js：embed 只认正斜杠/，反斜杠被忽略或导致匹配失效 - 路径含
./或../：编译直接报错，embed 明确禁止向上跳转 - 大小写不一致（如本地是
Logo.png，代码里写logo.png）：匹配失败且无提示 - 目录为空，或只含
.gitignore、_config.yml：embed 默认跳过，不报错也不嵌入
embed.FS 必须用 http.FS() 包装才能传给 http.FileServer
embed.FS 实现的是 fs.FS 接口，而 http.FileServer 要求的是 http.FileSystem 类型。直接传会编译失败：cannot use assets (type embed.FS) as type http.FileSystem。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 正确写法：
http.FileServer(http.FS(assets))，http.FS()是强制类型转换函数，不是类型名 - 如果挂载点是
/static/，必须加http.StripPrefix("/static/", ...)，否则请求/static/app.js会去查app.js（没带前缀），必然 404 - 若嵌入的是子目录（如
//go:embed ui/），想让/static/映射到ui/内容，得先fs.Sub(assets, "ui")切子树，再套http.FS()——fs.Sub返回的仍是embed.FS，不能省
模板文件不能用 template.ParseFiles，必须用 fs.ReadFile
template.ParseFiles("templates/index.html") 底层调用 os.Open，而 embed 文件根本不在磁盘上，只存在于二进制只读段里，必然 panic：open templates/index.html: no such file or directory。
- 单个模板：用
fs.ReadFile(assets, "templates/index.html")读出[]byte，再template.Must(template.New("index").Parse(string(b))) - 多个模板：需逐个读取后合并解析，或用
template.ParseGlob配合fs.Glob（但注意fs.Glob不支持通配符递归，得手动遍历目录） - 路径必须与
//go:embed声明严格一致：如果声明是//go:embed templates，那读取时路径是"index.html"；如果声明是//go:embed templates/*.html，那路径仍是"index.html"，不是"templates/index.html"
嵌入后路径是“虚拟”的，读取时不能拼接、不能变量、不能跨模块
//go:embed 是编译期指令，所有路径必须是字面量字符串，静态可解析。任何动态行为都会导致编译失败。
- 不允许：
//go:embed "assets/" + env、//go:embed ${ASSET_DIR}、//go:embed ./assets/* - 资源分散在多级目录时，宁可拆成多个声明：
//go:embed static/*和//go:embed views/*.html，比盲目用**更可控 - 读取失败时用
errors.Is(err, fs.ErrNotExist)判断，别用os.IsNotExist(err)—— 对 embed 返回 false - 调试建议：在启动时用
fs.ReadDir(assets, ".")打印顶层内容，确认实际可用路径结构
最易被忽略的其实是路径的“虚拟性”：嵌入声明决定了运行时路径的根，而这个根和你本地开发时看到的磁盘路径几乎总是不一致的。一旦混淆，所有 fs.ReadFile 都会失败，且错误信息不提示真实原因。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
