Python案例如何批量删除文件？

wen python案例 2026-06-08 61

Python案例：如何批量删除文件？——从入门到实战的完整指南

目录导读

为什么需要批量删除文件？
准备工作：Python环境与核心库
基础案例：删除指定目录下所有txt文件
进阶案例：按文件年龄删除（如30天前的文件）
高级案例：删除包含特定关键词的文件
安全实践：删除前的文件预览与恢复机制
常见问题问答（FAQ）
总结与最佳实践

为什么需要批量删除文件？

在日常工作和学习中,我们常常遇到以下场景：

Python案例如何批量删除文件？

下载文件夹中积累了大量临时文件（.tmp、.log）
项目目录中残留了旧版本的备份文件
服务器日志文件占用了大量磁盘空间
重复的图片、文档需要清理

手动逐个删除不仅效率低下,还容易误删重要文件，使用Python脚本进行批量删除，可以精确控制删除条件，同时自动处理大量文件，本文将通过3个真实案例，带你掌握批量删除的核心技巧。

准备工作：Python环境与核心库

1 环境要求

Python 3.6+ （推荐使用3.9及以上版本）
操作系统：Windows / macOS / Linux

2 核心库

不需要安装第三方库,Python内置的os和pathlib模块即可实现99%的功能：

import os
from pathlib import Path
import time  # 用于时间判断

注意：删除操作不可逆，建议先在测试目录中运行脚本。

基础案例：删除指定目录下所有txt文件

场景：清理Downloads文件夹中所有.txt文档。

1 实现代码

import os
def delete_files_by_extension(directory, extension):
    """
    删除指定目录下所有特定扩展名的文件
    :param directory: 目标目录路径
    :param extension: 文件扩展名，如 '.txt'
    """
    deleted_count = 0
    for root, dirs, files in os.walk(directory):
        for file in files:
            if file.endswith(extension):
                filepath = os.path.join(root, file)
                try:
                    os.remove(filepath)
                    print(f"已删除: {filepath}")
                    deleted_count += 1
                except Exception as e:
                    print(f"删除失败 {filepath}: {e}")
    print(f"总计删除 {deleted_count} 个 {extension} 文件")
# 使用示例
delete_files_by_extension('/path/to/your/downloads', '.txt')

2 关键点解析

os.walk()：递归遍历目录树
endswith()：安全判断文件后缀
os.remove()：执行物理删除
异常处理：避免权限不足或文件占用导致脚本中断

3 运行效果示例

已删除: /Downloads/report.txt
已删除: /Downloads/notes.txt
总计删除 2 个 .txt 文件

进阶案例：按文件年龄删除（如30天前的文件）

场景：服务器日志文件每天生成，只需保留最近30天的日志。

1 实现代码

import os
import time
from datetime import datetime, timedelta
def delete_old_files(directory, days_old=30, extension=None):
    """
    删除超过指定天数的文件
    :param directory: 目标目录
    :param days_old: 文件年龄阈值（天）
    :param extension: 可选，指定文件类型
    """
    cutoff_time = time.time() - (days_old * 24 * 3600)
    today = datetime.now().strftime("%Y-%m-%d")
    deleted_count = 0
    for root, dirs, files in os.walk(directory):
        for file in files:
            if extension and not file.endswith(extension):
                continue
            filepath = os.path.join(root, file)
            try:
                file_mtime = os.path.getmtime(filepath)  # 修改时间
                if file_mtime < cutoff_time:
                    os.remove(filepath)
                    print(f"[{today}] 删除过期文件: {filepath}")
                    deleted_count += 1
            except Exception as e:
                print(f"处理失败 {filepath}: {e}")
    print(f"共删除 {deleted_count} 个过时文件")
# 使用示例：删除30天前的.log文件
delete_old_files('/var/log/app', days_old=30, extension='.log')

2 时间判断逻辑

os.path.getmtime()：获取文件最后修改时间（时间戳）
days_old参数：动态调整保留天数
可选extension：避免误删非日志文件

高级案例：删除包含特定关键词的文件

场景：清理包含“temp”或“backup”关键词的临时文件。

1 实现代码

import os
import re
def delete_files_by_keyword(directory, keywords, case_sensitive=False):
    """
    删除文件名包含指定关键词的文件
    :param directory: 目录路径
    :param keywords: 关键词列表，如 ['temp', 'backup']
    :param case_sensitive: 是否区分大小写
    """
    pattern = '|'.join(keywords)
    if not case_sensitive:
        pattern = pattern.lower()
    deleted_count = 0
    for root, dirs, files in os.walk(directory):
        for file in files:
            filename = file if case_sensitive else file.lower()
            if re.search(pattern, filename):
                filepath = os.path.join(root, file)
                try:
                    os.remove(filepath)
                    print(f"已删除匹配文件: {filepath}")
                    deleted_count += 1
                except Exception as e:
                    print(f"删除失败: {e}")
    print(f"共删除 {deleted_count} 个文件")
# 使用示例：删除包含"temp"或"backup"的文件（不区分大小写）
delete_files_by_keyword('/path/to/clean', ['temp', 'backup'])

2 灵活扩展

正则匹配：支持更复杂的文件名模式（如^2023.*\.tmp$）
多条件组合：同时检查关键词和扩展名
日志记录：将删除记录写入文件以备审计

安全实践：删除前的文件预览与恢复机制

1 关键防护原则

def safe_delete_with_preview(directory, **conditions):
    """
    安全删除：先预览文件列表，确认后再删除
    """
    preview_files = []
    # 收集符合条件的文件列表（伪代码）
    for file in scan_files(directory, **conditions):
        preview_files.append(file)
    print(f"即将删除以下 {len(preview_files)} 个文件：")
    for f in preview_files:
        print(f"  - {f}")
    confirm = input("是否继续删除？(yes/no): ")
    if confirm.lower() == 'yes':
        # 执行实际删除
        for f in preview_files:
            os.remove(f)
        print("删除完成")
    else:
        print("已取消操作")

2 数据恢复建议

先移动后删除：将文件移动到回收站或临时目录，而非直接os.remove()
使用send2trash库：安装pip install send2trash，调用send2trash.send2trash()将文件移至回收站
创建日志记录：保存被删除文件的完整路径和时间戳

常见问题问答（FAQ）

Q1：批量删除时如何跳过子目录？

A：使用os.listdir()代替os.walk()，但需要注意仅处理当前目录的文件：

import os
for file in os.listdir('/target/dir'):
    if os.path.isfile(os.path.join('/target/dir', file)):
        # 处理文件

Q2：删除过程中遇到权限错误怎么办？

A：

以管理员身份运行脚本（Windows右键->以管理员身份运行）

使用os.chmod()先修改文件权限：

os.chmod(filepath, 0o644)
os.remove(filepath)

Q3：如何删除空文件夹？

A：使用os.rmdir()，但需先确认文件夹为空：

def delete_empty_dirs(root_dir):
    for dirpath, dirnames, filenames in os.walk(root_dir, topdown=False):
        if not dirnames and not filenames:
            os.rmdir(dirpath)
            print(f"删除空文件夹: {dirpath}")

Q4：可以同时删除多种文件类型吗？

A：当然可以，只需修改扩展名判断逻辑：

extensions = ('.tmp', '.log', '.bak')
if file.endswith(extensions):
    os.remove(filepath)

Q5：如何确保只删除文件而不误删系统文件？

A：建议：

明确指定删除目录,避免使用C:\或
添加白名单检查（排除特定目录/文件）
先用预览模式运行一遍

总结与最佳实践

1 关键要点回顾

安全第一：始终使用预览模式，先读后删
异常处理：捕获PermissionError、FileNotFoundError等常见异常
日志记录：记录删除操作以备审计
条件精准：明确文件扩展名、年龄、关键词等筛选条件

2 推荐使用流程

graph TD
    A[定义清理规则] --> B[编写筛选条件]
    B --> C[预览文件列表]
    C --> D{确认删除?}
    D -- 是 --> E[执行删除并记录日志]
    D -- 否 --> F[退出或修改条件]
    E --> G[验证删除结果]

3 扩展阅读资源

Python官方文档：os模块、pathlib模块
实用库推荐：send2trash（回收站删除）、shutil.rmtree（删除目录树）
实战案例：自动化每周清理临时文件、Docker容器日志清理

记住：批量删除脚本应像手术刀一样精准，避免造成不可挽回的数据丢失，建议在非生产环境充分测试后，再应用到实际工作中。