os.RemoveAll不能替代递归清理，因其无差别删除整个路径（含目录本身），而递归清理需保留目录结构、按条件过滤（如跳过.git）、自定义处理（限速/日志/dry-run），必须用filepath.WalkDir遍历并逆序安全删除。
为什么 os.RemoveAll 不能直接替代递归清理
因为 os.RemoveAll 会无差别删除整个路径，包括目标目录本身；而“递归清理”通常指清空目录内容但保留目录结构（比如保留空目录、不删权限位、不破坏 symlink 目标）。更关键的是，它无法按条件过滤——你没法跳过某些子目录（如 .git）、保留特定文件（如 README.md），或对每个条目做自定义处理（如记录日志、限速、dry-run）。
实际场景中，常见需求是：清理构建产物（./dist、./node_modules）、清空缓存但留配置、CI 中重用工作目录。这时候必须自己走一遍遍历逻辑。
用 filepath.WalkDir 遍历并安全删除
filepath.WalkDir 是 Go 1.16+ 推荐的遍历方式，相比旧版 filepath.Walk 更高效（避免重复 stat），且支持在回调中返回 filepath.SkipDir 控制跳过子树——这对排除 .git、vendor 等非常关键。
删除顺序必须从底向上（即先删叶子，再删父目录），否则会因子项未清空导致 remove directory not empty 错误。所以遍历本身要反向收集路径，或用后序遍历策略：
立即学习“go语言免费学习笔记（深入）”；
// 示例：收集所有可删路径，逆序处理
var paths []string
filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
if err != nil {
return err
}
// 跳过 .git、隐藏文件等
if d.Name() == ".git" || strings.HasPrefix(d.Name(), ".") {
if d.IsDir() {
return filepath.SkipDir
}
return nil
}
if !d.IsDir() {
paths = append(paths, path)
}
return nil
})
// 逆序删除：先文件，再目录（从深到浅）
for i := len(paths) - 1; i >= 0; i-- {
os.Remove(paths[i])
}
- 务必检查
d.IsDir()再决定是否调用filepath.SkipDir，否则可能跳过不该跳的文件 - 不要在遍历回调里直接
os.RemoveAll(path)—— 它会干扰当前遍历器状态，引发 panic 或漏删 - 若需保留空目录，只删文件、跳过
d.IsDir()的条目即可
处理权限、只读文件和 Windows 符号链接
在 Linux/macOS 上，只读文件（如 chmod -w file）调用 os.Remove 会报 permission denied；Windows 下，符号链接（symlink）若指向不存在路径，os.Remove 可能失败而非静默忽略。
稳妥做法是：先尝试 os.Remove，失败时检查错误类型，对只读文件先 os.Chmod(path, 0644) 再删；对 symlink 则用 os.Lstat 判断是否为 symlink 后，用 os.Remove（它删的是 link 本身，不是 target）：
err := os.Remove(path)
if err != nil {
if os.IsPermission(err) {
if err2 := os.Chmod(path, 0644); err2 == nil {
err = os.Remove(path)
}
}
}
- Windows 上
os.RemoveAll对 symlink 处理较脆弱，手动删更可控 - 不要用
os.Stat替代os.Lstat检查 symlink，前者会跟随链接，失去判断依据 - 清理前建议加 dry-run 模式：把
os.Remove换成fmt.Println("would remove:", path)
并发删除带来的问题与节流控制
并发删大量小文件看似快，但实际容易触发系统级限制：Linux 的 inotify 句柄耗尽、ext4 日志压力、磁盘 I/O 队列拥塞，反而比串行慢，且错误更难定位（如 too many open files）。
若真需要并发，推荐用带缓冲的 goroutine 池（如 semaphore 控制并发数 ≤ 8），且仅对文件删除并发，目录删除仍保持串行（因目录删依赖子项已清空）：
sem := make(chan struct{}, 8)
for _, path := range files { // files 是所有非目录路径
sem <- struct{}{}
go func(p string) {
defer func() { <-sem }()
os.Remove(p)
}(path)
}
- 并发删目录（
os.Remove目录）几乎必然失败，因为子项可能还没删完 - 并发数不是越多越好，SSD 上 4–8 并发通常最优；HDD 建议 ≤ 2
- 别忘了用
sync.WaitGroup等待所有 goroutine 结束，否则主流程可能提前退出
最常被忽略的一点：清理操作不可逆，哪怕加了 --dry-run，也要确保路径参数拼写绝对正确——少个 / 可能从 /tmp/myapp 变成删掉整个 /tmp。建议在生产环境强制要求传入绝对路径，并用 filepath.Abs 校验。
