推荐用pathlib替代os模块进行批量重命名,因其路径拼接、存在性检查、后缀判断更直观安全,且跨平台兼容性好、错误提示更明确。

用 os.listdir() 和 os.rename() 做基础批量重命名
直接遍历目录、拼路径、调用重命名是最常见的做法,但容易因路径处理出错导致文件找不到或重命名失败。
-
os.listdir()只返回文件名,不带路径,必须手动拼接完整路径,否则os.rename()会报FileNotFoundError - 重命名前务必检查目标路径是否存在同名文件,否则旧文件会被静默覆盖(
os.rename()不提示) - Windows 对文件名长度和非法字符更敏感,比如
:、*、?会直接抛OSError
示例:把当前目录下所有 .txt 文件前加 backup_
import os
for name in os.listdir('.'):
if name.endswith('.txt'):
old = os.path.join('.', name)
new = os.path.join('.', 'backup_' + name)
os.rename(old, new)
为什么推荐用 pathlib 替代 os 模块
pathlib 写起来更直观,路径拼接、后缀判断、存在性检查都自带方法,少写错漏;而且它在 Python 3.4+ 是标准库,无需额外安装。
-
Path.iterdir()返回的是Path对象,自带.stem、.suffix、.exists(),不用再切字符串或拼路径 -
Path.rename()报错信息更明确,比如目标已存在时抛FileExistsError,比os.rename()的泛化OSError更易定位 - 跨平台兼容性更好——
Path('a/b').joinpath('c')在 Windows 自动用\,Linux/macOS 用/,不用操心os.sep
等价的 pathlib 写法:
立即学习“Python免费学习笔记(深入)”;
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构,支持CLI、API、爬虫、Bot、Django等多种项目类型,包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
from pathlib import Path
for f in Path('.').iterdir():
if f.is_file() and f.suffix == '.txt':
new = f.with_name(f'backup_{f.name}')
if not new.exists():
f.rename(new)
批量重命名时怎么安全地处理序号和时间戳
按顺序编号(如 img_001.jpg)或加时间戳(如 report_20240520.pdf)很常用,但容易踩两个坑:序号位数不统一导致排序错乱,时间戳取的是脚本运行时刻而非文件修改时间。
- 用
f'{i:03d}'格式化序号,避免从1跳到10后排序错位 - 如果想按文件修改时间排序重命名,得用
f.stat().st_mtime,而不是time.time() - 注意中文路径在部分旧系统上可能触发
UnicodeEncodeError,建议显式用errors='ignore'或提前过滤
按修改时间升序重命名示例:
from pathlib import Path
files = sorted(Path('.').glob('*.log'), key=lambda x: x.stat().st_mtime)
for i, f in enumerate(files, 1):
new = f.with_name(f'log_{i:04d}{f.suffix}')
f.rename(new)
遇到 PermissionError 或只读文件怎么办
Windows 下常见,尤其从压缩包解压出来的文件默认带只读属性,os.rename() 和 Path.rename() 都会直接失败。
- 先用
f.stat().st_file_attributes & 0x1(Windows)或os.access(f, os.W_OK)(通用)检查可写性 - 临时去掉只读属性:Windows 用
f.chmod(f.stat().st_file_attributes & ~0x1),其他系统用f.chmod(f.stat().st_mode | 0o200) - 别跳过错误继续跑——某些文件重命名失败后,后续逻辑可能依赖它已就位,导致连锁出错
安全重命名封装建议:
def safe_rename(src, dst):
if dst.exists():
raise FileExistsError(f'{dst} already exists')
try:
src.rename(dst)
except PermissionError:
src.chmod(src.stat().st_mode | 0o200)
src.rename(dst)
实际用的时候,最麻烦的不是写几行代码,而是确认原始文件列表是否真按你预期被筛选出来——建议先打印预览(print([f.name for f in files])),再执行重命名。

















