Python3使用os模块删除文件夹的完整指南

os模块文件夹删除基础

1. 删除空文件夹

使用os.rmdir()方法可以删除一个空文件夹：

import os

# 指定要删除的文件夹路径
folder_path = "empty_folder"

try:
    # 删除空文件夹
    os.rmdir(folder_path)
    print(f"成功删除文件夹: {folder_path}")
except FileNotFoundError:
    print(f"文件夹不存在: {folder_path}")
except OSError as e:
    print(f"删除失败: {e}")

2. 检查文件夹是否存在

在删除文件夹前进行存在性检查是良好实践：

import os

folder_path = "my_folder"

if os.path.exists(folder_path):
    if os.path.isdir(folder_path):
        try:
            os.rmdir(folder_path)
            print(f"成功删除文件夹: {folder_path}")
        except OSError as e:
            print(f"删除失败: {e}")
    else:
        print(f"{folder_path} 是文件，不是文件夹")
else:
    print(f"文件夹不存在: {folder_path}")

删除非空文件夹的解决方案

递归删除文件夹（自定义函数）

对于非空文件夹，我们需要编写递归函数来删除所有内容：

import os
import shutil

def delete_folder(folder_path):
    """安全删除文件夹及其所有内容"""
    if not os.path.exists(folder_path):
        print(f"文件夹不存在: {folder_path}")
        return
    
    try:
        # 使用shutil.rmtree删除非空目录
        shutil.rmtree(folder_path)
        print(f"成功删除文件夹及其内容: {folder_path}")
    except Exception as e:
        print(f"删除失败: {e}")

# 使用示例
delete_folder("non_empty_folder")

仅使用os模块的递归删除

如果项目限制只能使用os模块，可以这样实现：

import os

def delete_folder_os(folder_path):
    """仅使用os模块递归删除文件夹"""
    if not os.path.exists(folder_path):
        return
    
    # 遍历文件夹内容
    for item in os.listdir(folder_path):
        item_path = os.path.join(folder_path, item)
        
        if os.path.isfile(item_path) or os.path.islink(item_path):
            # 删除文件或链接
            os.remove(item_path)
        elif os.path.isdir(item_path):
            # 递归删除子文件夹
            delete_folder_os(item_path)
    
    # 删除空文件夹
    try:
        os.rmdir(folder_path)
        print(f"成功删除: {folder_path}")
    except OSError as e:
        print(f"删除失败 {folder_path}: {e}")

# 使用示例
delete_folder_os("folder_to_delete")

最佳实践与安全注意事项

权限问题处理

处理权限问题可能需要额外步骤：

import os
import stat

def reset_permissions(path):
    """重置文件/文件夹权限"""
    os.chmod(path, stat.S_IRWXU | stat.S_IRWXG | stat.S_IRWXO)

def safe_delete(folder_path):
    """安全删除文件夹，处理权限问题"""
    for root, dirs, files in os.walk(folder_path):
        for file in files:
            file_path = os.path.join(root, file)
            reset_permissions(file_path)
        for dir in dirs:
            dir_path = os.path.join(root, dir)
            reset_permissions(dir_path)
    
    # 现在可以安全删除
    shutil.rmtree(folder_path)

实际应用场景

import os
import tempfile

# 创建临时文件夹
temp_dir = tempfile.mkdtemp()

# ...使用临时文件夹...

# 使用后清理
try:
    shutil.rmtree(temp_dir)
    print(f"临时文件夹已清理: {temp_dir}")
except Exception as e:
    print(f"清理失败: {e}")

def clean_build_artifacts(project_root):
    """删除构建生成的文件夹"""
    build_dirs = ["build", "dist", "__pycache__", "*.egg-info"]
    
    for pattern in build_dirs:
        for path in glob.glob(os.path.join(project_root, pattern)):
            if os.path.isdir(path):
                print(f"删除构建目录: {path}")
                shutil.rmtree(path)