嵌入式文件必须用 embed.fs + fs.readfile 读取，os.readfile 永远失败，因嵌入文件仅存于二进制只读段，不在磁盘上；路径须严格匹配 //go:embed 前缀且不可运行时拼接，声明需紧贴 embed.fs 变量。
嵌入式文件必须用 embed.FS + fs.ReadFile 读，os.ReadFile 永远失败——这不是路径问题，是 API 用错。
为什么 os.ReadFile("assets/index.html") 总报 “no such file or directory”
嵌入文件只存在于二进制的只读段里，根本不在磁盘上。os 系列函数只查磁盘路径，对 embed 完全无感知。
- 错误写法：
os.ReadFile("assets/index.html")→ 编译不报错，运行时 panic - 正确写法：
fs.ReadFile(assets, "assets/index.html")，其中assets是声明为embed.FS的变量 - 路径必须严格匹配
//go:embed声明前缀：比如写的是//go:embed ui/**，就读ui/main.css；写的是//go:embed static/*，就读static/logo.png - 禁止运行时拼接路径：
fs.ReadFile(assets, dir+"/config.json")中dir是变量，编译期无法解析，直接报错
embed.FS 读取性能怎么优化
每次调用 fs.ReadFile 都会新分配 []byte，高频访问（如模板渲染、API 响应头）下开销明显。
- 静态 HTML/JS/CSS：启动时一次性读出，缓存为全局
var indexHTML []byte - Go 1.16+ 模板：优先用
template.ParseFS，它内部已做缓存和解析优化，比手动fs.ReadFile+template.Parse更安全 - 按需加载（如多语言 JSON）：封装带
sync.Once的懒加载函数，确保只读一次
fs.ReadDir 返回空或 panic 怎么办
fs.ReadDir 行为高度依赖嵌入路径精度，不是 bug，是 embed 的设计约束。
-
//go:embed assets/**不等于“递归包含所有子文件”，它只是前缀展开；真正嵌入的是当前包内真实存在、可读、非隐藏的文件 - 路径严格区分大小写：
Assets/和assets/是两个路径，Windows/macOS 文件系统不敏感，但 embed 敏感 - 以
.或_开头的文件（如.gitignore、_config.yml）会被自动跳过；前端构建产物里的.nojekyll就会丢 - 空目录不会被嵌入：
fs.ReadDir(assets, "empty/")返回io.EOF或空切片；想保留结构，得在空目录里放个.keep
开发时改了 HTML 却没更新？别怪 embed
embed 是纯编译期行为，go run 每次都重新编译，但 IDE 右键 Run 的工作目录可能不是项目根，导致 //go:embed 找不到文件，静默失效。
最容易被忽略的是：嵌入路径是相对于当前 .go 文件的，不支持 .. 向上跳转；Windows 下必须用 / 作分隔符（不是 \）；//go:embed 必须紧贴变量声明，中间不能有空行或注释。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
