os.rmdir() 无法删除含只读文件的目录，因其仅支持删除空目录且不自动处理权限；遇到只读文件时会抛 permissionerror，需配合 chmod 修改权限或改用 shutil.rmtree() 并设置 onerror 回调。
os.rmdir() 为什么删不掉带只读文件的目录？
因为 os.rmdir() 只能删除空目录，且不处理文件权限；一旦目录里有只读文件（比如 Windows 的 read-only 属性或 Unix 的 0444 权限），os.remove() 在内部清理时就会抛 PermissionError，导致整个递归中断。
这不是 bug，是设计使然——os 模块的底层函数默认尊重系统权限策略，不会自动“强删”。
- 常见错误现象：
PermissionError: [WinError 5] 拒绝访问或OSError: [Errno 13] Permission denied - 触发场景：从 Git 克隆的目录、用
zipfile解压的资源、IDE 自动生成的缓存文件夹 - 关键点：问题不在“递归”，而在“删除只读文件”这一步卡住
用 shutil.rmtree() + onerror 参数绕过只读限制
shutil.rmtree() 是标准方案，但它默认也会在只读文件上失败。必须配合 onerror 回调函数，在出错时手动改权限再重试。
这个回调函数接收三个参数：func（报错的函数，如 os.remove）、path（出错路径）、exc_info（异常信息），你只需在里面调用 os.chmod(path, 0o777) 再执行一次 func(path) 即可。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- Windows 下只读属性由文件权限位模拟，
os.chmod(path, 0o777)足够解除 - Unix/Linux/macOS 下需确保目标路径不是 root 所有，否则仍可能失败
- 不要用
lambda写onerror——它无法捕获exc_info，会导致重试失败
import os
import shutil
<p>def remove<em>readonly(func, path, </em>):
os.chmod(path, 0o777)
func(path)</p><p>shutil.rmtree("my_folder", onerror=remove_readonly)
</p>
os.walk() + 手动控制删除顺序更可控
如果需要精细干预（比如跳过某些子目录、记录失败路径、或兼容旧版 Python），用 os.walk() 自己遍历更透明。关键是**先删文件，再删目录**，并为每个文件/目录单独加权限修复逻辑。
- 必须倒序遍历
dirs列表（dirs[::-1]），否则父目录删了，子目录路径就失效了 -
os.remove()对只读文件失败时，同样要先os.chmod()再删；os.rmdir()同理 - 注意：不要在
os.walk()循环中直接修改dirs，要用切片副本避免迭代异常
import os <p>def safe_rmtree(path): for root, dirs, files in os.walk(path, topdown=False): for file in files: fpath = os.path.join(root, file) os.chmod(fpath, 0o777) os.remove(fpath) for dir in dirs[::-1]: # 倒序确保子目录先删 dpath = os.path.join(root, dir) os.chmod(dpath, 0o777) os.rmdir(dpath) os.chmod(path, 0o777) os.rmdir(path) </p>
跨平台要注意的权限细节
Windows 和类 Unix 系统对“只读”的理解不同：Windows 的只读属性影响文件删除，但不影响目录；而 Unix 的 write 权限同时控制文件修改和目录内增删。所以 os.chmod(path, 0o777) 在 Windows 上对目录无效，但对文件有效；在 Linux 上对两者都有效。
- 安全起见，所有路径（文件和目录）都调用一次
os.chmod(..., 0o777)，没坏处 - macOS 上若启用了 SIP（系统完整性保护），用户目录下某些路径即使 root 也无法强删，这时得提前检查
os.access(path, os.W_OK) - Python 3.12+ 开始，
shutil.rmtree()默认启用onexc参数替代onerror，但兼容性考虑，目前仍推荐用onerror
真正容易被忽略的是：很多脚本只修复了文件权限，却忘了给空目录也加写权限，结果 os.rmdir() 依然失败。只要记住“删之前一律 chmod 0o777”，基本就稳了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
