os.rename() 重命名失败主因是目标路径已存在，因其不覆盖只搬移；需先检查存在性、规范拼路径、打印确认映射、注意长路径和大小写限制，pathlib 更安全但行为一致。
Python 的 os.rename() 为什么重命名失败？
常见报错是 OSError: [WinError 183]（Windows）或 FileExistsError（macOS/Linux），本质是目标路径已存在——os.rename() 不覆盖，只“搬移”。批量处理时，如果多个文件被重命名成同一个名字，或旧名/新名路径没写对，立刻崩。
实操建议：
- 先用
os.path.exists()检查目标路径是否已存在，存在则跳过、报错或加序号后缀 - 始终用
os.path.join()拼路径，别手拼"folder\" + filename，跨平台直接跪 - 重命名前用
print()打印出“旧→新”映射，确认无误再执行，别一上来就rename() - Windows 下注意文件名长度限制（260 字符），长路径要用
\?前缀（但os.rename()不支持，得换shutil.move()）
用 pathlib 替代 os 操作更稳吗？
是的，尤其在路径拼接、后缀判断、遍历过滤上更直观。但要注意：pathlib.Path.rename() 和 os.rename() 行为一致——不覆盖、不自动建父目录。
实操建议：
- 用
file.parent / f"new_{file.stem}.txt"构造新路径，比字符串拼接少出错 -
file.suffix取后缀（含点），file.stem取主名，避免手写filename.split(".")[-1]错判archive.tar.gz - 目标目录不存在时，必须提前调用
target_dir.mkdir(parents=True, exist_ok=True)，否则报FileNotFoundError - 不要依赖
Path.rename()自动处理大小写重命名（如a.txt → A.txt），Windows/macOS 默认不区分，会静默失败
字符串替换逻辑怎么避开“替错了”？
比如想把所有 "v1" 换成 "v2"，结果把 "version1.0" 也干掉了；或者用 str.replace() 把 "log" 替换成 "debug_log"，导致 "logging" 变成 "debug_logging"。
实操建议：
- 优先用正则
re.sub(r"(? 限定单词边界，避免误伤 - 若只换文件名开头/结尾，用
name.startswith("old_")+name.removeprefix("old_")（Python 3.9+）或切片更安全 - 涉及大小写敏感控制时，明确加
flags=re.IGNORECASE，别靠系统默认 - 测试时拿几个典型文件名（含空格、括号、emoji、中文）跑一遍，别只用
test1.txt验证
批量重命名卡死或慢得离谱？
不是代码慢，是 I/O 瓶颈。尤其是网络盘、加密盘、或大量小文件时，每次 rename() 都触发一次系统调用，叠加路径解析、权限检查、日志记录，速度断崖下跌。
实操建议：
- 用
os.scandir()替代os.listdir()，减少 stat 调用次数，提速明显 - 避免在循环里反复调用
os.path.isdir()或Path.is_file()，一次scandir返回的对象自带.is_file()方法 - 不追求“一步到位”，先生成新名列表存内存，确认无误再统一执行重命名
- SSD 上差异不大，但机械硬盘或 NAS 上，把文件按目录分批处理（每批 50–100 个），比单次全量更稳
最易被忽略的是：重命名操作不可逆，没备份就直接改，哪怕逻辑再对，一个意外断电或路径错位，就是整批丢。别省那几秒 shutil.copy2() 备份原文件的时间。
