能，但必须用//go:embed assets/**显式声明递归路径，assets/仅嵌入一级文件；读取时需带完整前缀如"assets/css/main.css"，且目录只能ReadDir、文件才能ReadFile。
embed.FS 能否直接读取嵌套子目录下的文件
能，但必须显式声明整个目录树路径，embed.FS 不支持通配符递归匹配。如果你只写 //go:embed assets，它只会嵌入 assets 目录下**一级**的文件（不含子目录），除非你明确写出 assets/**。
常见错误是以为 assets/ 自动包含所有后代文件，结果运行时 fs.ReadFile("assets/css/main.css") 报 no such file or directory —— 因为 css/ 子目录根本没被 embed 进去。
- 正确写法：
//go:embed assets/**（双星号表示递归包含所有子目录和文件） - 错误写法：
//go:embed assets/或//go:embed assets（仅嵌入 assets 下平级文件） - 注意：路径分隔符统一用正斜杠
/，即使在 Windows 上也别用\
如何安全遍历嵌入的多层目录结构
embed.FS 的 ReadDir 方法返回的是 fs.DirEntry 列表，它**不递归**；要列出 assets/img/icons/ 下所有文件，得一层层调用 ReadDir，不能指望一次调用拿到全路径树。
更关键的是：嵌入文件系统里没有“真实路径”，所有路径都是相对于 embed 声明根目录的字符串，且必须用 / 分隔。硬编码拼接容易出错，比如误写成 "assets/img/icons/" + name 而不是 "assets/img/icons/" + entry.Name()。
- 推荐先用
fs.ReadDir("assets")拿到第一层，再对每个DirEntry判断IsDir()，再递归调用fs.ReadDir(subpath) - 避免用
filepath.Join拼路径——它在 Windows 上会生成\，导致fs.ReadFile找不到文件 - 示例片段：
entries, _ := fs.ReadDir("assets") for _, e := range entries { if e.IsDir() { subEntries, _ := fs.ReadDir("assets/" + e.Name()) // 继续处理... } }
embed.FS 读取嵌套路径时的常见 panic 场景
最典型的 panic 是 panic: cannot read directory "assets/css": is a directory，这发生在你对一个目录路径调用了 fs.ReadFile（而非 ReadDir）。Go 的 embed.FS 对目录和文件做了严格区分：目录只能 ReadDir，文件才能 ReadFile。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
另一个隐蔽问题是路径末尾带斜杠，比如 fs.ReadFile("assets/css/") —— 即使该路径实际对应一个目录，ReadFile 也不会自动去掉斜杠并尝试读取默认文件（如 index.html），而是直接报错。
- 务必在调用
ReadFile前确认目标是文件：info, _ := fs.Stat(path); if !info.IsDir() { ... } - 路径字符串不要以
/结尾，除非你明确知道那是目录且准备用ReadDir - 调试时可用
fs.ReadDir(".")查看根目录下有哪些项，验证嵌入是否符合预期
构建时嵌入资源的路径一致性陷阱
//go:embed 声明的路径是相对于 **源文件所在目录** 的，不是项目根目录或 go build 当前工作目录。如果 embed 注释写在 cmd/app/main.go 里，而资源在 ./assets/，那就要写 //go:embed ../assets/**，否则编译器找不到。
多人协作时尤其容易踩坑：有人把 embed 写在 internal/asset/loader.go，路径就得变成 ../../assets/**；一旦文件移动，嵌入路径就失效，且编译不报错——只是运行时读不到文件。
- 建议将 embed 声明统一放在项目根目录下的
embed.go文件中，路径写//go:embed assets/**，保持基准一致 - 用
go:embed后跟空行，再跟变量声明，避免注释被其他工具误解析 - 构建后可用
go tool dist list -v或反汇编go tool objdump -s "main\.init" ./yourbinary粗略验证资源是否嵌入成功（非必需，但调试深层问题时有用）
嵌套目录本身不难，难的是路径语义在 embed 声明、代码内路径字符串、操作系统路径习惯三者之间反复横跳；稍不注意，就是运行时静默失败。
