fs.ReadFile报“no such file or directory”是因为用os.ReadFile读嵌入文件（其不在磁盘上），正确做法是用fs.ReadFile(assetsFS, "ui/index.html")，路径须严格匹配//go:embed前缀且为编译期字面量，大小写敏感、不支持./../、空目录和隐藏文件被忽略。
为什么 fs.ReadFile 报 “no such file or directory”
这不是磁盘路径没找到，而是你用了 os.ReadFile 去读 embed.FS 里的内容——它根本不在磁盘上。
- 错误写法：
os.ReadFile("ui/index.html")→ 必然 panic - 正确写法：
fs.ReadFile(assetsFS, "ui/index.html")，其中assetsFS是你声明的embed.FS变量 - 路径必须严格对齐：
//go:embed ui/*→ 读取时必须带ui/前缀；//go:embed static/**→ 仍得写static/css/main.css - 判断缺失要用
errors.Is(err, fs.ErrNotExist)，不是os.IsNotExist(err)
//go:embed 编译失败或静默忽略的真正原因
只有两个可能：路径不合法，或声明不合规。没有其他隐藏条件。
-
//go:embed路径必须是相对于go.mod所在目录的字面量，不能含./、../或变量；写//go:embed ./ui/*直接报错，得写//go:embed ui/* - 路径必须真实存在且非空——
ui/下若全是空目录，embed会跳过整个路径，不报错也不嵌入 -
//go:embed指令必须紧挨着var声明，中间不能有空行、注释或其它语句 - 以
.或_开头的文件（如.gitignore、_config.yml）默认被忽略；前端构建产物里若有.nojekyll就会丢
http.FileServer 提供嵌入资源时为啥 404
不是路径写错，而是类型没转或子树没切分。
- 错误写法：
http.FileServer(assetsFS)→ 编译失败：类型不匹配，embed.FS不是http.FileSystem - 正确写法：
http.FileServer(http.FS(assetsFS))——http.FS()是必需的适配器 - 如果路由是
/static/，必须用http.StripPrefix("/static/", ...)，否则请求/static/logo.png会被传给http.FS去查static/logo.png，但实际嵌入路径可能是assets/logo.png - SPA 场景下刷新 404，是因为没 fallback handler；需手动 wrap 一个兜底逻辑
开发时改了 HTML 却没更新？别怪 embed
embed 是纯编译期行为，但 IDE 运行时工作目录可能不是项目根，导致 //go:embed 静默失效。
立即学习“go语言免费学习笔记（深入）”；
- 嵌入路径是相对于该
.go文件所在目录的，不是相对于项目根或main.go - Windows 下必须用
/作分隔符（不是\）；Assets/和assets/是两个路径，大小写敏感 - 空目录不会被嵌入：
fs.ReadDir(assetsFS, "empty/")返回io.EOF或空切片；想保留结构，得在空目录里放个.keep - 调试建议：先用
fs.ReadDir(assetsFS, ".")打印顶层结构，确认路径是否真被嵌入进来了
