os.remove()和shutil.rmtree()默认失败因不自动处理只读权限；需配合chmod修正权限后重试，或用onerror回调、pathlib逆序遍历等方案确保彻底清理。
为什么 os.remove() 和 shutil.rmtree() 默认会失败
直接调用 os.remove() 删除只读文件会抛出 PermissionError: [WinError 5] 拒绝访问（Windows）或 PermissionError: Permission denied（Linux/macOS）；而 shutil.rmtree() 遇到只读文件时，在 Windows 上常卡在“无法删除只读文件”，Linux/macOS 则可能因权限不足或目录非空但含只读子项而中断。根本原因是：Python 的这些函数不自动处理文件系统权限位，也不接管错误回调逻辑。
用 shutil.rmtree() 配合 onerror 回调强制清理
这是最通用、跨平台的方案。关键不是“绕过权限”，而是捕获错误后主动修正权限再重试。
常见错误现象：shutil.rmtree() 报错后整个目录停止删除，哪怕只有一两个只读文件。
实操建议：
- 定义一个回调函数，检查错误类型是否为
PermissionError，且操作是'rmdir'或'unlink' - 对目标路径调用
os.chmod(path, stat.S_IWRITE)（Windows）或os.chmod(path, 0o755)（Unix），再尝试重试 - 注意：回调中不能直接再次调用
shutil.rmtree()，否则无限递归；应只对单个失败路径做 chmod + unlink/rmdir
示例片段：
import os
import stat
import shutil
def _force_remove(path):
os.chmod(path, stat.S_IWRITE)
if os.path.isdir(path):
os.rmdir(path)
else:
os.remove(path)
def onerror(func, path, _):
if not os.access(path, os.W_OK):
_force_remove(path)
else:
raise
shutil.rmtree("target_dir", onerror=onerror)
Windows 下额外注意：os.remove() 对只读文件直接失败，os.unlink() 行为相同
这两个函数在 Windows 上完全等价，都不修改属性。想单删一个只读文件，必须先 os.chmod(path, stat.S_IWRITE)，再 os.remove(path)。漏掉 chmod 就必然报错。
使用场景：清理临时生成的只读配置文件、日志归档后设为只读但仍需定期轮转删除。
容易踩的坑：
- 只对文件调用
os.chmod()，却忘了目录也需要可写权限才能删除其内容（rmtree内部会先尝试os.rmdir()） - 在 Linux 上误用
stat.S_IWRITE（它是 Windows 专用宏），应改用0o755或stat.S_IRWXU - 未检查路径是否存在就调用
os.chmod()，导致FileNotFoundError
替代方案：用 pathlib.Path().rglob() + 手动逐层清理更可控
当需要精细控制顺序（比如先删文件再删空目录）、或需跳过特定子路径时，比 shutil.rmtree() 更灵活。
性能影响：对超深层目录（>1000 层），递归遍历略慢于原生 rmtree，但可避免一次性加载全部路径到内存。
实操要点：
- 用
pathlib.Path("root").rglob("*")获取所有子孙路径，逆序排序（确保子路径优先于父路径） - 逐个处理：文件 →
chmod + unlink；目录 →chmod + rmdir - 最后删根目录本身，同样要先
chmod
注意：逆序必须用 sorted(paths, key=lambda p: len(p.parts), reverse=True) 或类似逻辑，不能只靠字符串排序。
真正麻烦的从来不是“删不掉”，而是删到一半出错后状态残留——比如部分子目录被删了，部分只读文件卡住，目录变成半空半锁。所以无论选哪种方式，都要确保 chmod 调用成功后再执行删除，并在关键步骤加 try/except 记录实际失败项。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
