安全重命名需预检目标路径是否存在，用时间戳或UUID生成唯一新名，结合shutil.move()和文件名清洗（避保留字、截长、转义非法字符）以规避Windows异常。
重命名时遇到同名文件会直接报错 OSError: [WinError 183]
Windows 下用 os.rename() 或 pathlib.Path.rename() 把文件 A 改成和已存在文件 B 相同的名字，系统会直接拒绝并抛出这个错误。Linux/macOS 虽然默认覆盖，但多数场景下你并不想丢数据——所以得主动处理冲突，而不是依赖系统行为。
核心思路是：每次 rename 前先检查目标路径是否存在，存在则生成新名字（如加序号、时间戳），再尝试。不能靠 try/except 捕获后再重试，因为并发或快速连续操作时可能漏判。
- 用
pathlib.Path.exists()预检，比 try/except 更可靠 - 避免用递增数字如
file (1).txt→file (2).txt，容易被手动创建的文件干扰；推荐用带毫秒的时间戳或 UUID 后缀 - 如果批量量大（比如上万文件），预检 + 重命名要加锁或串行化，否则多线程下仍可能撞车
用 shutil.move() 替代 os.rename() 更安全
shutil.move() 在跨文件系统时自动降级为 copy + unlink，且对目标存在性判断更鲁棒；更重要的是，它不强制覆盖，配合预检逻辑更可控。
示例逻辑：
立即学习“Python免费学习笔记（深入）”；
from pathlib import Path
import shutil
def safe_rename(src: Path, dst: Path) -> Path:
if not dst.parent.exists():
dst.parent.mkdir(parents=True)
counter = 0
candidate = dst
while candidate.exists():
counter += 1
stem = dst.stem + f"_v{counter}"
candidate = dst.parent / f"{stem}{dst.suffix}"
shutil.move(src, candidate)
return candidate
- 注意
dst.parent.mkdir(parents=True)防止目标目录不存在时报错 - 后缀统一用
_v{N}比括号更易解析、排序、正则匹配 - 如果原文件在另一磁盘，
shutil.move()自动走 copy+delete，不会因跨设备失败
批量处理时必须保留原始顺序或加唯一标识
如果你按列表顺序 rename，但文件名生成规则只依赖目标名（比如都叫 report.pdf），那多个源文件会竞争同一个目标名，最终只剩一个胜出——其余被重命名到带序号的变体，但你未必知道哪个是“原本该叫 report.pdf”的那个。
- 建议在重命名前，把原始文件路径哈希或索引号嵌入新名，例如
report_20240521_7a3f.pdf（7a3f是原文件名 hash 前4位） - 或者用
datetime.now().strftime("%Y%m%d_%H%M%S%f")[:15]保证毫秒级唯一，但要注意 Windows 文件名长度限制（260 字符） - 别用
time.time()整数秒，高并发下极易重复
Windows 下长路径和保留字导致的隐性失败
即使解决了重名，CON、AUX、NUL 等设备名，或含 :、、<code>> 的名字，在 Windows 上 rename 会静默失败或报错 Invalid argument。
- 用正则预清洗文件名：
re.sub(r'[:"/\|?* - ]', '_', name) - 检查长度：
len(str(dst)) > 260时截断 stem（保留扩展名） - 避开保留字：对
dst.stem.upper()做集合判断，如{"CON", "PRN", "AUX", "NUL"}.intersection(stem_parts)
真正麻烦的不是重名，而是你以为改成功了，结果文件进了回收站、卡在挂起状态、或被系统拦截却没报错——这些边界情况得在 rename 前全链路校验。
