Go限制目录遍历深度应优先用filepath.WalkDir配合fs.SkipDir按路径分隔符计数控制深度，或用os.ReadDir手动实现两层遍历；避免filepath.Walk因强制stat性能差且跳过不可控。
Go 语言里限制目录遍历深度，不是靠“关掉递归开关”，而是靠主动控制进入子目录的时机和条件。核心就两条：用 filepath.WalkDir 配合 fs.SkipDir，或用 os.ReadDir 手动展开两层——前者适合通用深度控制，后者适合固定浅层（如仅当前目录 + 一级子目录）。
用 filepath.WalkDir 控制最大深度
这是 Go 1.16+ 推荐方式，性能好、可控性强，且能精准跳过超深目录。
-
filepath.WalkDir的回调函数接收fs.DirEntry，调用d.IsDir()不触发额外系统调用，比os.Stat()快 - 深度计算靠统计路径分隔符数量：
strings.Count(path, string(filepath.Separator))，但要注意 root 路径本身可能含分隔符（如/tmp），建议统一转绝对路径再算 - 若当前路径深度已达上限且条目是目录，返回
fs.SkipDir即可跳过其全部子树；返回其他错误（如errors.New("stop")）会中断整个遍历 - 别在回调里手动拼接路径，比如
path + "/sub"——Windows 下会出错；要用filepath.Join(path, "sub")
用 os.ReadDir 实现严格两层遍历
当需求明确为“只处理当前目录及其直接子目录下的文件”（即 depth ≤ 1），os.ReadDir 显式两层循环比 Walk 更清晰、更安全，也彻底规避了软链接环路或路径错乱风险。
- 第一层：调
os.ReadDir(root)，对每个条目判断：if !d.IsDir() → 处理文件；if d.IsDir() → 记录子目录路径 - 第二层：对上一步收集的所有子目录路径，再各调一次
os.ReadDir(subPath)，只处理其中的普通文件（跳过子目录里的子目录） - 不用
filepath.Walk或递归调用，避免file.Name()返回 basename 导致路径错乱（例如在docs/中误调Walk("index.html")） - 注意：
os.ReadDir返回的是相对条目名，构造完整路径必须用filepath.Join(root, d.Name())
为什么不用 filepath.Walk？
它在遇到权限错误时容易静默终止，不支持可控跳过子树，且每次回调都强制调用 os.Stat()，性能差、容错弱。
立即学习“go语言免费学习笔记（深入）”；
-
filepath.Walk的WalkFunc签名含os.FileInfo，意味着每次访问必做一次stat系统调用，大目录下开销明显 - 返回
filepath.SkipDir在某些旧版本中行为不稳定；而filepath.WalkDir的fs.SkipDir是底层 fs 接口原生支持，更可靠 - 无法在进入目录前预判是否跳过——
filepath.Walk总是先stat再回调，而WalkDir的DirEntry可在回调开头就决定去留 - 若项目需兼容 Go 1.15-，降级用
filepath.Walk时，务必自己缓存os.FileInfo，避免重复 stat
真正容易被忽略的点是：深度计算依赖路径格式一致性。相对路径在不同工作目录下结果不同，os.Getwd() 可能被中间代码修改，所以限制深度前最好先 filepath.Abs(root)。另外，符号链接默认不跟随，若需解析，得自己用 os.ReadDir + os.Stat 判断并展开，不能指望 WalkDir 自动处理。
