os.RemoveAll不能用于清理空目录，它会删除整个路径包括目录本身；正确做法是用os.ReadDir递归判断目录是否为空并白名单过滤后安全删除。
os.RemoveAll 不能用于清理“空目录”
它删的是整个路径，包括目录本身，而“清理空目录”要求保留非空目录、只删那些确实为空的层级。用 os.RemoveAll 直接套用，结果是把整个子树连根拔起——这不是清理，是误删。
真实场景中，分布式文件系统（如 CephFS、GlusterFS 挂载点）常因元数据不一致或客户端异常退出，残留大量深度嵌套的空目录（比如 /data/shard/001/2024/06/23/14/），它们占 inode、干扰路径统计，但又不能动上级非空结构。
- 必须区分“空目录”和“可删目录”：空 ≠ 可删，有些空目录是服务运行必需的占位符（如 Kafka 日志分片目录）
-
os.Stat+os.ReadDir是唯一可靠判断方式；filepath.WalkDir会遍历所有项，无法跳过非空分支，反而增加开销 - 不要依赖
os.Remove的错误返回（如ENOTEMPTY）反推是否为空——某些 NFS 实现对空目录也报错，不可靠
用 os.ReadDir 手动递归判断空目录
Go 1.16+ 的 os.ReadDir 返回 fs.DirEntry 列表，零开销获取 Name() 和 IsDir()，避免海量 os.Stat 系统调用，这对分布式挂载点尤其关键（NFS 延迟高、CephFS 元数据压力大）。
核心逻辑是：对每个目录，os.ReadDir 读一次，若返回空 slice 或全是 . / ..（注意不同文件系统行为差异），再确认自身不是保护路径，才标记为待删。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 先做白名单/黑名单过滤：
if d.Name() == ".keep" || strings.HasPrefix(d.Name(), "_")直接跳过该目录，不递归也不删 - 对每个子项，仅当
d.IsDir()为 true 且名字非./..时，才递归进子目录检查——避免无效遍历 - 路径拼接用
strings.Builder缓存父路径，builder.WriteString(filepath.Separator); builder.WriteString(name)，比反复filepath.Join快 3～5 倍（实测 10 万级目录）
并发删空目录要防“目录忙”和挂载点越界
分布式文件系统里，并发 os.Remove 同一父目录可能触发元数据锁冲突，尤其在 CephFS 上报 Device or resource busy，不是进程占用，而是 OSD 正在同步目录版本。
- 删目录前加轻量级探测：
f, _ := os.Open(path); f.Close()—— 成功说明目录可访问，失败则跳过（不重试） - 限制并发数：
sem := make(chan struct{}, runtime.NumCPU()/4)，每 goroutine 获取 token 后再删，避免打爆 MDS - 绝对禁止跨挂载点：用
os.Stat(path)拿dev字段，与根目录dev对比，不等则return（Linuxstat_t.Dev，Windows 需GetVolumeInformation） - Windows SMB 挂载点要额外处理符号链接：
os.Lstat判断是否为 symlink，是则跳过（os.Remove删 symlink 本身，但分布式系统里 symlink 往往指向远端路径）
删完后 mtime 不更新，监控脚本会误判
分布式系统常用 find /path -type d -mmin +60 扫描闲置目录，但 os.Remove 空目录后，父目录的 mtime 不变——它没被修改，只是子项少了。结果是监控反复告警，以为目录“一直空着”。
这不是 bug，是 POSIX 语义：目录内容变更不触发父目录时间戳更新。除非你显式调用 os.Chtimes(parent, time.Now(), time.Now())，但要注意：
- 只对刚删完子项的直接父目录调用，别层层向上刷——会放大元数据压力
- CephFS 不支持
utimesat(AT_SYMLINK_NOFOLLOW)，调os.Chtimes可能静默失败，需检查返回 err 是否为syscall.ENOSYS - 更稳妥的做法是让监控逻辑改用
os.ReadDir实时判断空与否，而非依赖时间戳
