go:embed 只能嵌入编译时存在、路径固定且在当前包内的只读文件；路径须严格匹配大小写与相对位置，* 不递归、** 递归但不包含空目录；需用 http.fs() 转换类型才能用于 http.fileserver。
go:embed 只能嵌入编译时就存在的、路径固定的只读文件，不能嵌入变量、运行时路径或上级目录（如 ../config.yaml），否则直接报错。
为什么 //go:embed assets/* 没生效？常见路径错误
embed 不是“找文件”，而是编译器在 go build 当前工作目录下，按字面路径去匹配真实存在的文件。路径写错、大小写不一致、多了 ./ 或 ../，都会静默失败或报 pattern matches no files。
-
//go:embed assets/*✅ 正确：当前.go文件所在目录下必须有assets/子目录，且里面至少有一个非隐藏文件 -
//go:embed ./assets/*❌ 错误：带./会被拒绝，提示invalid pattern: must be relative path -
//go:embed ../static/logo.png❌ 错误：跨出当前包路径，编译直接失败 -
//go:embed templates/index.html❌ 失败可能：文件名其实是Index.html（Windows/macOS 开发易忽略大小写）
嵌入整个目录时，** 和 * 到底怎么选？
* 不递归，只匹配一级；** 才递归，但不是 shell glob，只是 embed 的简单展开规则——它会把 assets/** 理解为“assets/ 下所有层级的文件”，但不会匹配 assets/ 本身（目录没内容就不算）。
- 要嵌入
static/css/main.css和static/js/app.js→ 用//go:embed static/** - 只嵌
templates/*.html，不进子目录 → 用//go:embed templates/*.html - 想嵌根目录下所有资源（不含隐藏文件）→
//go:embed .，但注意它不会包含.gitignore或_config.yml
为什么 http.FileServer(staticFiles) 编译不过？
embed.FS 实现的是 fs.FS，而 http.FileServer 需要的是 http.FileSystem。类型不兼容，必须显式转换。
- ✅ 正确写法：
http.FileServer(http.FS(staticFiles)) - ⚠️ 如果嵌入的是
static/**，但你想通过/static/xxx访问 → 要先fs.Sub(staticFiles, "static")切出子树，再套http.FS，否则路径对不上 - ❌ 直接传
staticFiles给http.FileServer→ 报错：cannot use staticFiles (type embed.FS) as type http.FileSystem
开发时改了 HTML 却没变化？这不是 bug，是设计
go:embed 是编译期行为，go run 每次执行都会重新编译，但你得确保资源文件在编译那一刻确实存在。改了 ui/index.html 后没反应，大概率是因为没触发重编译（比如用了 IDE 缓存），或者路径根本没被 embed 命中。
- 验证是否真嵌进去了：在代码里加
fs.ReadDir(staticFiles, ".")打印看看 - 开发阶段建议加构建标签，比如
//go:build !dev+go run -tags dev，跳过 embed，直读磁盘 - 空目录不会被嵌入：
static/img/下如果没文件，那整个目录就不存在于embed.FS中 —— 得放个.keep文件占位
最常被忽略的点：路径大小写、斜杠方向、http.FS 包装、以及嵌入范围和运行时读取路径的严格一致性。少一个条件，就是 file does not exist panic。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
