Python 删除文件夹报错：os.remove 与 os.rmdir 的区别及正确做法

为什么 os.remove 会报错？

许多开发者习惯使用 os.remove(path) 来删除文件，但在处理文件夹时，该函数会直接抛出 PermissionError（拒绝访问）。这是因为 os.remove 的设计初衷仅用于删除文件，它无法处理包含子目录和文件的目录结构。

os.rmdir 的局限性

Python 标准库提供了 os.rmdir(path) 专门用于删除目录。然而，它有一个严格的前提条件：目标目录必须是空的。如果文件夹内包含任何文件或子文件夹，os.rmdir 会抛出 OSError，提示“目录非空”。

正确做法：使用 shutil.rmtree

要彻底删除一个包含内容的文件夹，最标准且推荐的方法是使用 shutil 模块中的 rmtree 函数。该函数能够递归地删除目录及其所有内容（包括子目录和文件）。

import shutil
import os

# 定义要删除的文件夹路径
dir_path = '/path/to/your/folder'

# 检查文件夹是否存在
if os.path.exists(dir_path):
    try:
        # 递归删除文件夹及其所有内容
        shutil.rmtree(dir_path)
        print(f"成功删除文件夹: {dir_path}")
    except Exception as e:
        print(f"删除失败: {e}")
else:
    print("文件夹不存在")

注意事项

• 权限问题：确保运行脚本的用户对目标文件夹拥有读写和删除权限。
• 只读文件：在某些操作系统（如 Windows）上，如果文件夹内存在“只读”属性的文件，shutil.rmtree 可能会失败。此时可结合 os.chmod 修改权限后再删除，或处理 PermissionError。
• 不可恢复：使用 rmtree 删除的数据无法通过回收站恢复，操作前请确认路径正确。