shutil.rmtree可递归删除非空目录，但遇Windows只读文件会抛PermissionError；需传入三参数onerror回调，先用os.chmod(path, stat.S_IWRITE)改权限，再调用func(path)重试。
shutil.rmtree 会直接删除非空目录，但默认不处理只读文件
调用 shutil.rmtree 确实能递归删掉整个目录树，包括子目录和所有文件，但它在遇到 Windows 下的只读文件（比如 .git 里的文件）时会抛出 PermissionError。这不是“删不了”，而是 Python 默认尊重系统权限位，不会主动改写文件属性。
常见错误现象：PermissionError: [WinError 5] 拒绝访问: 'xxx\xxx.py'，尤其在删除含 .git 或 IDE 生成缓存的目录时高频出现。
- 解决方法是传入
onerror回调函数，在出错时先去掉只读属性再重试 - 不要用
os.system("rm -rf")或subprocess调 shell —— 跨平台性差，且绕过 Python 的异常控制流 - Python 3.12+ 提供了
ignore_errors=False参数（默认），但依然不自动修复权限，onerror仍是可靠解法
onerror 回调必须接受三个参数：func、path、exc_info
shutil.rmtree 要求 onerror 是一个三参数函数，否则会报 TypeError。它不是让你“捕获异常后忽略”，而是给你机会干预删除逻辑。
典型写法：
立即学习“Python免费学习笔记（深入）”；
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
import os
import stat
import shutil
def remove_readonly(func, path, _):
"清除只读位并重试一次"
os.chmod(path, stat.S_IWRITE)
func(path)
shutil.rmtree("mydir", onerror=remove_readonly)
-
func是失败的系统调用（如os.remove或os.rmdir） -
path是出错的具体路径（文件或空目录） - 第三个参数是
sys.exc_info()元组，通常用不到，下划线占位即可 - 别漏掉
os.chmod(path, stat.S_IWRITE)—— 这步不做，重试仍会失败
shutil.rmtree 在 NFS 或符号链接挂载点上可能静默失败
如果目标路径位于 NFS、Docker volume 或通过 ln -s 挂载的目录中，shutil.rmtree 可能删掉符号链接本身，但不进入其指向的目标；或者因服务器端权限限制卡在某一层，既不报错也不继续。
使用场景判断：
- 先用
os.path.islink(path)检查是否为符号链接 —— 若是，需决定是删链接还是删目标 - 对 NFS 路径，建议加超时控制：用
threading.Timer包裹调用，避免阻塞主线程 - Linux 下可配合
find . -xdev -delete验证是否真删干净（-xdev防跨文件系统误删）
替代方案：pathlib.Path.rmdir 不支持非空目录，别误用
有人看到 pathlib.Path.rmdir() 就想拿来删非空目录，结果触发 OSError: The directory is not empty。这是设计使然：rmdir() 对应系统 rmdir(2)，仅支持空目录。
正确选择：
- 要删非空目录 → 坚持用
shutil.rmtree+onerror - 只删空目录 → 用
pathlib.Path.rmdir()更语义清晰，且自动处理路径对象 - 想保留父目录只清内容 → 用
shutil.rmtree(path / "*")不行（glob 不支持通配符递归），得手动遍历path.iterdir()再逐个删
最常被忽略的是：onerror 函数里改完权限后必须显式调用 func(path)，否则就只是改了权限，没真正执行删除。
