Python批量改名技巧：os模块+字符串处理

本文深入解析了Python中批量重命名文件的核心技巧与实战陷阱，从传统os模块的易错操作（如路径拼接错误、静默覆盖、Windows非法字符报错）出发，强力推荐更现代、安全、跨平台的pathlib替代方案，并详解其在路径处理、存在性检查、错误提示等方面的显著优势；同时覆盖序号格式化、按修改时间排序、中文路径兼容、只读文件权限处理等高频痛点，辅以可直接复用的健壮代码示例和安全封装建议，助你一次写对、零误操作地完成高效可靠的批量重命名任务。

用 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 写法：

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])），再执行重命名。

理论要掌握，实操不能落！以上关于《Python批量改名技巧：os模块+字符串处理》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！