embed.fs 不支持 filepath.walkdir，因其无真实目录结构；应使用 fs.readdir 递归遍历，路径拼接用 filepath.join，入口传空字符串 ""，并手动处理深度限制与错误。
embed.FS 不能用 filepath.WalkDir 遍历
直接传 filepath.WalkDir 一个 embed.FS 实例会 panic：「embed.FS does not support walking root」。这不是权限或路径写错的问题，而是设计限制——embed.FS 是编译期生成的扁平化只读文件系统，没有真实目录结构，filepath.WalkDir 底层依赖 os.ReadDir 系统调用，无法适配。
正确遍历 embed.FS 要用 fs.ReadDir 递归
必须用 fs.ReadDir（不是 os.ReadDir），配合手动递归逻辑：
-
fs.ReadDir(fsys, "")获取根目录所有条目（即嵌入内容顶层） - 对每个
entry，若entry.IsDir()为 true，则再次调用fs.ReadDir(fsys, entry.Name()) - 路径拼接必须用
filepath.Join(parent, entry.Name())，硬拼字符串在 Windows 下会出错 -
entry.Type()只返回os.ModeDir或 0（普通文件），不支持符号链接、权限、修改时间等
fs.Glob 只适合简单通配匹配
fs.Glob 能快速查匹配路径，但有明显局限：
- 只能匹配嵌入时已知的静态路径模式，比如
fs.Glob(fsys, "*.go")或fs.Glob(fsys, "config/*.yaml") - 不支持
**递归通配，也不能动态判断文件类型或过滤内容 - 前缀必须严格匹配嵌入声明路径，比如
//go:embed assets/*，那fs.Glob(fsys, "assets/**.png")才有效；若写成"**.png"就返回空切片
深度控制和错误处理要自己加
embed.FS 本身不会循环或越界，但递归实现若没设限，容易栈溢出（尤其嵌入了大量层级目录时）：
- 建议用闭包计数器限制最大深度，超过后直接跳过子目录（
return nil） - 每个
fs.ReadDir调用都可能返回非 nil error（虽然极少，但编译器不保证），必须检查 - 别在递归里无条件调用
entry.Info()——它在embed.FS中返回固定假数据，且徒增开销
最易被忽略的是路径拼接方式和递归起点：传空字符串 "" 给 fs.ReadDir 才是获取嵌入内容的正确入口，不是 "./" 也不是 "/"。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
