如何用Python案例实现批量修改文件后缀？

wen python案例 2026-06-17 2

如何用Python案例实现批量修改文件后缀？完整代码+避坑指南

目录导读

为什么需要批量修改文件后缀？
核心方法对比：os模块与pathlib模块
实战案例一：使用os模块实现基础版重命名
实战案例二：pathlib模块的现代优雅写法
高级应用：递归修改子文件夹内所有文件
常见问题与避坑指南
选择适合你的方案

为什么需要批量修改文件后缀？

在日常办公或数据处理中,我们经常会遇到以下场景：

如何用Python案例实现批量修改文件后缀？

从网站下载的图片全部是.webp格式，需要统一改为.jpg
系统导出的日志文件统一为.txt，但后续处理工具要求.log格式
下载的音频文件后缀不规范,需要统一为.mp3

手动逐个修改不仅耗时,而且容易出错，Python作为自动化利器，只需几行代码就能解决这个问题。本文将通过三个由浅入深的案例，教会你如何用Python安全、高效地批量修改文件后缀。

核心方法对比：os模块与pathlib模块

特性	os模块	pathlib模块
兼容性	Python 2/3均支持	Python 3.4+
代码可读性	较低，需拼接路径	高，面向对象风格
处理复杂路径	需要手动处理	自动跨平台兼容
推荐场景	旧项目维护	新项目首选

问答环节
Q：新手应该选择哪个模块？
A：推荐pathlib，它更符合现代Python风格，且能避免手动拼接路径带来的转义错误，如果你在维护老旧代码，才考虑使用os模块。

实战案例一：使用os模块实现基础版重命名

import os
def batch_rename_os(folder_path, old_ext, new_ext):
    """
    使用os模块批量修改文件后缀
    :param folder_path: 目标文件夹路径
    :param old_ext: 原后缀（如'.txt'）
    :param new_ext: 新后缀（如'.csv'）
    """
    count = 0
    for filename in os.listdir(folder_path):
        if filename.endswith(old_ext):
            # 分离文件名和后缀
            name_without_ext = os.path.splitext(filename)[0]
            old_file = os.path.join(folder_path, filename)
            new_file = os.path.join(folder_path, name_without_ext + new_ext)
            try:
                os.rename(old_file, new_file)
                count += 1
                print(f'已修改: {filename} -> {name_without_ext}{new_ext}')
            except Exception as e:
                print(f'修改失败 {filename}: {e}')
    print(f'完成！共修改 {count} 个文件')
# 使用示例
batch_rename_os(r'C:\Users\你的文件夹', '.txt', '.csv')

关键要点：

使用os.path.splitext()安全拆分文件名和后缀
用os.path.join()构建完整路径，避免手动加导致的转义问题
添加异常处理防止单个文件失败导致程序中断

实战案例二：pathlib模块的现代优雅写法

from pathlib import Path
def batch_rename_pathlib(folder_path, old_ext, new_ext):
    """
    使用pathlib模块批量修改文件后缀（推荐）
    """
    folder = Path(folder_path)
    count = 0
    # 使用glob模式匹配特定后缀的文件
    for file_path in folder.glob(f'*{old_ext}'):
        # 构建新文件名
        new_name = file_path.stem + new_ext
        new_path = file_path.with_name(new_name)
        try:
            file_path.rename(new_path)
            count += 1
            print(f'已修改: {file_path.name} -> {new_name}')
        except Exception as e:
            print(f'修改失败 {file_path.name}: {e}')
    print(f'完成！共修改 {count} 个文件')
# 使用示例
batch_rename_pathlib('/home/user/文档', '.jpg', '.png')

为什么推荐这个写法？

glob('*.old_ext')直接过滤文件，无需手动判断后缀
file_path.stem返回不含后缀的文件名，比手动分割更安全
with_name()方法自动处理路径拼接，跨平台无压力

高级应用：递归修改子文件夹内所有文件

当文件分散在多级目录中时,需要递归遍历：

from pathlib import Path
def recursive_rename(folder_path, old_ext, new_ext):
    """
    递归修改文件夹及其子文件夹内的所有文件后缀
    """
    folder = Path(folder_path)
    count = 0
    # rglob递归匹配所有子目录
    for file_path in folder.rglob(f'*{old_ext}'):
        if file_path.is_file():  # 确保只处理文件
            new_name = file_path.stem + new_ext
            new_path = file_path.with_name(new_name)
            try:
                file_path.rename(new_path)
                count += 1
                print(f'已修改: {file_path.relative_to(folder)} -> {new_name}')
            except Exception as e:
                print(f'修改失败 {file_path.name}: {e}')
    print(f'完成！共修改 {count} 个文件')
# 示例：修改文档文件夹下所有txt为md
recursive_rename('/Users/me/Documents', '.txt', '.md')

注意：使用rglob方法（递归glob），比glob多扫描所有子文件夹。

常见问题与避坑指南

Q1：修改后文件无法打开怎么办？
A：后缀修改仅改变文件名，不会转换文件格式，如果原文件是二进制格式（如Excel），错误修改后缀可能导致无法识别。建议先备份或小范围测试。

Q2：遇到权限错误如何解决？
A：检查文件是否被其他程序占用，可以先用os.access()检查权限，或使用管理员权限运行脚本。

Q3：文件名包含空格或特殊字符？
A：pathlib模块自动处理这些情况，如果使用os模块，务必使用os.path.join()而非手动字符串拼接。

Q4：如何批量修改文件名中的特定内容？
A：可在上述代码中加入字符串处理逻辑，

new_name = file_path.stem.replace('旧内容', '新内容') + new_ext

安全建议：

始终先打印计划修改的内容,确认无误后再执行
在代码中增加dry_run=True参数，模拟运行而不实际修改
重要文件操作前拷贝副本

选择适合你的方案

简单任务：直接使用pathlib + glob模式，5行代码搞定
复杂目录：使用rglob递归方案
需要自定义文件名：在stem属性基础上增加字符串替换

掌握了这些核心方法,你不仅能批量修改后缀，还能轻松扩展为批量重命名工具、文件分类整理脚本等实用工具。

练习挑战：尝试写一个交互式脚本，让用户输入文件夹路径和要修改的旧/新后缀，并增加“预览模式”选项，在修改前显示所有将要变更的文件列表。