为何shutil.rmtree删除文件夹有时耗时数小时？有替代方案吗？

可能的原因 #

• OneDrive后台同步锁定文件：即使你认为同步无影响，但OneDrive在后台处理文件时会临时锁定文件，shutil.rmtree删除时需要等待锁释放，海量文件场景下等待时间会被无限拉长。
• shutil.rmtree单线程效率低：它是单线程遍历删除文件，遇到大量小文件时，逐个处理的开销会导致总耗时暴增。
• 宽泛的异常处理掩盖问题：原代码中except: pass会忽略所有错误，若某个文件删除失败，可能导致内部阻塞或无法排查具体问题。

实用解决方案 #

1. 先暂停OneDrive同步再删除 #

删除前临时暂停OneDrive，避免文件锁定导致的等待，删除完成后恢复同步。Windows下可通过命令行控制：

# 暂停同步
%LOCALAPPDATA%\Microsoft\OneDrive\OneDrive.exe /pause
# 删除完成后恢复同步
%LOCALAPPDATA%\Microsoft\OneDrive\OneDrive.exe /resume

2. 改用系统原生删除命令 #

系统级删除命令比Python的shutil.rmtree效率高得多，尤其是处理大量文件时：

• Windows系统：

import subprocess
def delFolder(folderPath):
    try:
        subprocess.run(['rmdir', '/s', '/q', str(folderPath)], check=True)
    except subprocess.CalledProcessError as e:
        print(f"删除失败: {e}")

• Linux/macOS系统：

import subprocess
def delFolder(folderPath):
    try:
        subprocess.run(['rm', '-rf', str(folderPath)], check=True)
    except subprocess.CalledProcessError as e:
        print(f"删除失败: {e}")

3. 优化异常处理 #

不要使用裸except，捕获具体异常类型，方便排查问题：

def delFolder(folderPath):
    try:
        shutil.rmtree(folderPath)
    except FileNotFoundError:
        print("文件夹不存在，无需删除")
    except PermissionError:
        print("无权限删除文件夹")
    except Exception as e:
        print(f"删除出错: {str(e)}")

4. 多线程加速删除（可选） #

如果不想用系统命令，可通过线程池批量删除文件，提升效率：

import shutil
from pathlib import Path
from concurrent.futures import ThreadPoolExecutor

def delete_item(item_path):
    try:
        if item_path.is_file():
            item_path.unlink()
        elif item_path.is_dir():
            shutil.rmtree(item_path)
    except Exception as e:
        print(f"删除{item_path}失败: {e}")

def delFolder(folderPath):
    folder = Path(folderPath)
    if not folder.exists():
        return
    # 先收集所有文件和子文件夹，逆序删除（先删文件再删空文件夹）
    all_items = list(folder.rglob('*')) + [folder]
    all_items.reverse()
    with ThreadPoolExecutor(max_workers=8) as executor:
        executor.map(delete_item, all_items)

内容的提问来源于stack exchange，提问作者Prashant Kumar