embed.FS 路径必须与 //go:embed 声明精确匹配，区分大小写和斜杠方向；嵌入根目录用 //go:embed .，多级目录建议拆分声明；读取路径是虚拟的、相对于 embed 根；需用 http.FS 转换才能用于 HTTP 服务。
embed.FS 不能直接读取子目录外的文件
Go 的 embed.FS 在编译期打包资源，路径必须是相对且显式声明的。如果你写 //go:embed assets/** 却在代码里调用 fs.ReadFile("templates/index.html")，会 panic：`file does not exist`——因为 templates/ 根本没被 embed 指令覆盖。
- 确保
//go:embed指令的路径模式能精确匹配你后续fs.ReadFile或fs.Open时用的路径（区分大小写、斜杠方向） - 嵌入根目录建议用
//go:embed .，但要注意它不会递归包含隐藏文件（如.gitignore），也不包含上级目录内容 - 如果资源分散在多级目录，宁可拆成多个 embed 声明，比如：
//go:embed static/*和//go:embed views/*.html，比盲目用**更可控
使用 embed.FS 时注意文件路径是“虚拟”的，不是磁盘路径
嵌入后所有路径都是相对于 embed 声明的根目录计算的。比如你写了 //go:embed assets，那 assets/logo.png 在 FS 中的路径就是 logo.png，不是 assets/logo.png——除非你显式保留该前缀。
- 常见错误：把本地开发路径硬编码进代码，比如
fs.ReadFile("assets/logo.png")，而 embed 声明却是//go:embed assets→ 路径不匹配，报错file does not exist - 调试技巧：用
fs.ReadDir(".")打印顶层目录内容，确认实际可用路径结构 - 如果需要保留子目录层级，用
//go:embed assets/**并在读取时带上完整路径，例如fs.ReadFile("assets/logo.png")
embed 不支持运行时动态路径拼接或 glob 变量
//go:embed 是编译期指令，不接受变量、函数调用或字符串拼接。写 //go:embed "assets/" + env 或 //go:embed ${ASSET_DIR} 会直接导致编译失败。
- 所有要嵌入的路径必须是字面量字符串，且在 go build 时可静态解析
- 别试图用构建 tag 或条件编译来“切换” embed 路径——
//go:embed不受 build tag 影响，它只看当前文件是否被编译器读取 - 若需多环境资源（如 dev vs prod），建议用不同 embed 变量 + 构建参数控制文件是否参与编译，而不是动态改路径
HTTP 服务中用 embed.FS 需包装为 http.FileSystem
标准 http.FileServer 不认 embed.FS，直接传会编译报错：cannot use fs (type embed.FS) as type http.FileSystem。必须用 http.FS 转换。
立即学习“go语言免费学习笔记（深入）”；
- 正确写法：
http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.FS(myFS)))) - 注意
http.FS是一个转换函数，不是类型；它返回的是实现了http.FileSystem接口的值 - 如果嵌入的是单个文件（比如
//go:embed index.html），别用http.FileServer，直接http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { w.Write(data) })更轻量
fs.ReadDir(".") 看看实际结构，比查文档快得多。 
