17370845950

安全重命名需预检目标路径是否存在，用时间戳或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，且对目标存在性判断更鲁棒；更重要的是，它不强制覆盖，配合预检逻辑更可控。

示例逻辑：

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_20250521_7a3f.pdf（7a3f 是原文件名 hash 前4位）
• 或者用 datetime.now().strftime("%Y%m%d_%H%M%S%f")[:15] 保证毫秒级唯一，但要注意 Windows 文件名长度限制（260 字符）
• 别用 time.time() 整数秒，高并发下极易重复

Windows 下长路径和保留字导致的隐性失败

即使解决了重名，CON、AUX、NUL 等设备名，或含 :、、> 的名字，在 Windows 上 rename 会静默失败或报错 Invalid argument。

• 用正则预清洗文件名：re.sub(r'[:"/\\|?*\x00-\x1f]', '_', name)
• 检查长度：len(str(dst)) > 260 时截断 stem（保留扩展名）
• 避开保留字：对 dst.stem.upper() 做集合判断，如 {"CON", "PRN", "AUX", "NUL"}.intersection(stem_parts)

真正麻烦的不是重名，而是你以为改成功了，结果文件进了回收站、卡在挂起状态、或被系统拦截却没报错——这些边界情况得在 rename 前全链路校验。