Python os.rmdir()删除空目录用法详解 - 完整代码示例与注意事项

一、os.rmdir() 概述

os.rmdir() 是 Python 内置 os 模块中的一个函数，专门用于删除一个空目录。如果目标目录中还存在任何文件或子目录，该函数会抛出 OSError 异常，以防止意外删除有内容的目录。

这一设计使得 os.rmdir() 成为一个安全的删除操作——你不用担心它会误删包含重要文件的目录。如果需要删除非空目录及其所有内容，应当使用 shutil.rmtree()。

二、语法与参数说明

函数语法

os.rmdir(path, *, dir_fd=None)

参数详解

三、返回值与异常

os.rmdir() 函数没有返回值。删除成功时静默返回，删除失败时抛出异常。常见的异常类型包括：

• OSError：目录非空时抛出，这是最常见的错误

• FileNotFoundError：目录不存在时抛出

• PermissionError：没有删除权限时抛出

• NotADirectoryError：给定路径不是目录时抛出

四、代码示例

示例1：基本用法——删除空目录

import os

# 创建一个空目录
dir_path = 'empty_folder'
os.makedirs(dir_path, exist_ok=True)
print(f"创建目录: {dir_path}")

# 删除空目录
os.rmdir(dir_path)
print(f"删除目录: {dir_path}")
print(f"目录还存在: {os.path.exists(dir_path)}")

输出结果：

创建目录: empty_folder
删除目录: empty_folder
目录还存在: False

示例2：删除非空目录会报错

import os

# 创建一个非空目录
dir_path = 'not_empty'
os.makedirs(dir_path, exist_ok=True)
with open(os.path.join(dir_path, 'file.txt'), 'w') as f:
    f.write('hello')

# 尝试删除非空目录
try:
    os.rmdir(dir_path)
except OSError as e:
    print(f"错误: {e}")
    print("目录非空，无法使用os.rmdir()删除")

输出结果：

错误: [Errno 39] Directory not empty: 'not_empty'
目录非空，无法使用os.rmdir()删除

示例3：安全删除空目录的封装函数

import os

def safe_rmdir(path):
    """安全删除空目录，返回操作是否成功"""
    if not os.path.exists(path):
        print(f"目录不存在: {path}")
        return False
    if not os.path.isdir(path):
        print(f"不是目录: {path}")
        return False
    if os.listdir(path):
        print(f"目录非空: {path}")
        return False
    os.rmdir(path)
    print(f"删除成功: {path}")
    return True

# 测试安全删除函数
safe_rmdir('empty_folder')

输出结果：

删除成功: empty_folder

五、实际应用场景

• 临时目录清理：在数据处理或网络爬虫任务中，创建临时目录存放中间文件，处理完成后清空文件并用 os.rmdir() 删除空目录

• 构建产物清理：在项目构建或编译后，某些中间目录可能变为空目录，可以使用 os.rmdir() 进行清理

• 文件整理脚本：在自动化文件整理中，当某个分类目录下的文件被移走后，如果目录变空，可以自动删除该空目录

六、注意事项

注意：os.rmdir() 只能删除空目录，目录中只要有任何文件或子目录（包括隐藏文件）都会导致失败。

注意：如果需要删除非空目录（包括其中的所有文件和子目录），请使用 shutil.rmtree()。

注意：在 Windows 系统上，如果目录被其他程序占用（如资源管理器打开了该目录），可能会抛出 PermissionError 异常。建议删除前关闭所有占用该目录的程序。

七、删除目录方法对比

八、常见问题 FAQ

练习题