如何用Python案例实现批量修改文件后缀？完整代码+避坑指南
目录导读
- 为什么需要批量修改文件后缀？
- 核心方法对比：os模块与pathlib模块
- 实战案例一：使用os模块实现基础版重命名
- 实战案例二：pathlib模块的现代优雅写法
- 高级应用：递归修改子文件夹内所有文件
- 常见问题与避坑指南
- 选择适合你的方案
为什么需要批量修改文件后缀？
在日常办公或数据处理中,我们经常会遇到以下场景：
- 从网站下载的图片全部是
.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属性基础上增加字符串替换
掌握了这些核心方法,你不仅能批量修改后缀，还能轻松扩展为批量重命名工具、文件分类整理脚本等实用工具。
练习挑战：尝试写一个交互式脚本，让用户输入文件夹路径和要修改的旧/新后缀，并增加“预览模式”选项，在修改前显示所有将要变更的文件列表。
