最安全的清空目录方式是遍历子项逐个删除，保留根目录及其元数据：对文件和符号链接调用unlink()，对子目录递归调用rmtree()，并预先修正权限、处理异常。
用 shutil.rmtree + os.makedirs 清空目录最直接但有风险
这不是“清空”，而是先删后重建，会丢失原目录的权限、ACL、扩展属性（如 macOS 的 com.apple.FinderInfo），且中间存在短暂的文件夹不存在窗口——如果其他进程正监听该路径，可能触发异常。
更安全的做法是遍历删除内容，保留空目录本身：
- 用
os.listdir()获取所有子项，再逐个调用shutil.rmtree(path)（对目录）或os.unlink(path)（对文件） - 注意：不能直接对根路径调用
shutil.rmtree(root)，否则整个文件夹没了 - 建议加
follow_symlinks=False防止误删符号链接指向的目标
处理权限拒绝和只读文件的典型错误
常见报错：PermissionError: [WinError 5] 拒绝访问（Windows）或 PermissionError: [Errno 13] Permission denied（Linux/macOS），多因文件被占用、权限不足或只读位未清除。
必须在删除前修正文件状态：
- 对每个待删路径，先调用
os.chmod(path, 0o777)（Windows/Linux）或os.chmod(path, stat.S_IRWXU | stat.S_IRWXG | stat.S_IRWXO)（跨平台更稳） - Windows 下还需确保文件没被其他进程打开（如日志文件被编辑器锁定）
- 若仍失败，可捕获
PermissionError并记录路径，不中断整个清空流程
用 pathlib 实现简洁、可读的清空逻辑（Python 3.4+）
pathlib 比 os 系列更直观，且天然支持递归操作。关键点在于：只对子路径操作，不碰根路径本身。
from pathlib import Path
<p>def safe_clear_dir(root: Path):
if not root.is_dir():
raise NotADirectoryError(f"{root} is not a directory")
for item in root.iterdir():
if item.is_file() or item.is_symlink():
item.unlink(missing_ok=True)
elif item.is_dir():
shutil.rmtree(item)</p><h1>使用示例</h1><p>safe_clear_dir(Path("/tmp/my_cache"))
</p>
注意：missing_ok=True 是 Python 3.8+ 才支持的参数；旧版本需手动捕获 FileNotFoundError。
清空前校验和原子性保障的实际考量
没有真正的“原子清空”——操作系统不提供该语义。但可通过以下方式降低风险：
- 清空前检查磁盘空间是否足够（避免删到一半因空间不足失败）
- 若目录用于服务缓存，建议先停用相关服务，或用临时目录切换（
mv cache cache.old && mkdir cache） - 对重要目录，先备份元数据：
stat -c "%a %U:%G %y" /path > meta.bak（Linux） - 别依赖
os.walk清空——它可能因并发写入漏掉新创建的子项；iterdir()+ 递归更可控
真正容易被忽略的是：某些文件系统（如 NFS、某些容器卷）对 unlink 和 rmdir 的返回延迟敏感，可能需要短暂停顿或重试机制，而非假设一次调用就成功。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
