嵌入静态资源后需三步：路径对齐、fs.sub切前缀、http.fs类型转换，缺一不可；否则http.fileserver返回404。
嵌入静态资源后直接用 http.FileServer 会 404，不是资源没嵌进去，而是路径没对齐、类型没转换、MIME 没设 —— 这三步缺一不可。
embed.FS 必须包装成 http.FileSystem 才能给 http.FileServer 用
直接传 embed.FS 变量给 http.FileServer 会编译失败：cannot use fsys (type embed.FS) as type http.FileSystem。Go 的 http.FileServer 接口只认 http.FileSystem，而 embed.FS 是 fs.FS，两者不兼容。
- 必须用
http.FS(fsys)做一次类型转换，这是强制步骤 - 如果嵌入路径是
web/static/**，那fsys的根就是web/static/，意味着fsys里没有/main.js，只有main.js或css/main.css - 浏览器访问
/static/main.js时，请求路径带前缀，得用http.StripPrefix("/static/", ...)把前缀去掉，否则http.FileServer会去查static/main.js（不存在）而不是main.js
fs.Sub 控制挂载点，避免路径错位
你嵌入的是 web/static/**，但希望用户通过 /static/xxx 访问，就得把 web/static/ 这层前缀从虚拟路径里“切掉”。fs.Sub 就是干这个的 —— 它不是移动文件，而是创建一个子树视图。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 写法：
subFS, _ := fs.Sub(embedFS, "web/static")，注意第二个参数不能以/开头，也不能是.或.. - 错误写法：
fs.Sub(embedFS, "/web/static")→ 编译报错；fs.Sub(embedFS, ".")→ 无效操作 - 切完之后，
subFS的根就变成web/static/下的内容，fs.ReadFile(subFS, "main.js")才能成功 - 配合
http.FS(subFS)和http.StripPrefix("/static/", ...)，才能让/static/main.js正确命中main.js
读取失败永远返回 fs.ErrNotExist，别用 os.IsNotExist
调试时发现 fs.ReadFile 报 “file does not exist”，第一反应常是路径写错了。其实更可能是 //go:embed 指令失效或路径没对齐 —— 而且错误类型和 os 包不同，用错判断方式会永远走不到 fallback 分支。
- 正确判断：
if errors.Is(err, fs.ErrNotExist) - 错误判断：
os.IsNotExist(err)→ 对 embed 返回false，因为 embed 错误是*fs.PathError，不是*os.PathError - 调试建议：在服务启动时加一行
fs.ReadDir(embedFS, ".")，打印实际嵌入了哪些路径，确认web/static/main.js是否真在列表里 - 大小写敏感：本地 macOS 可能因文件系统不区分大小写而“侥幸”成功，部署到 Linux 就失败 —— 确保嵌入声明（如
//go:embed web/static/**）和读取路径（如"web/static/main.js"）完全一致
语言学习资源需按路径分类嵌入，避免通配符越界
比如单词表、音频、例句 HTML 都放在 lang/en/、lang/zh/ 下，不能靠 //go:embed lang/** 一把抓 —— 它会把所有子目录都塞进同一个 embed.FS，导致路径混乱、维护困难。
- 推荐拆开声明：
//go:embed lang/en/*.json+//go:embed lang/en/audio/*.mp3，每个变量职责清晰 -
//go:embed lang/**在 Go 1.19+ 支持递归，但若中间有空目录（如lang/ja/为空），该目录会被静默跳过，不报错也不警告 - 音频、PDF 等大文件慎 embed：10MB MP3 嵌进去，二进制立刻膨胀 10MB，且无法流式加载；建议保留外部路径 fallback，运行时先
os.Stat，失败再fs.ReadFile - MIME 类型不会自动推断：
http.ServeContent依赖扩展名，但 embed 没有真实文件系统元数据；若用http.FileServer，它内部会查路径后缀，所以确保路径含.js、.mp3等后缀，否则可能被当成text/plain
最易被忽略的其实是路径对齐：嵌入声明里的 web/static/**、代码里 fs.ReadFile("web/static/main.js")、HTTP 路由的 /static/ 前缀、fs.Sub 的切点 —— 四者必须严格咬合，差一个字符或一层斜杠，就 404。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
