结论：用 os.rename() 配合 re.sub() 和 unicodedata.normalize() 处理文件名，须先清洗非法字符、规避保留名、防重名覆盖，并用 os.path.join() 安全遍历子目录。
直接说结论：用 os.rename() 配合 re.sub() 或 unicodedata.normalize() 处理，但必须先规避 Windows 路径非法字符和重复文件名问题，否则会静默失败或覆盖。
为什么 os.rename() 直接报错“Invalid argument”？
Windows 对文件名有硬性限制：< > : " / | ? * 和 ASCII 控制字符（0x00–0x1F）完全禁止；macOS/Linux 虽宽松，但 / 和空字符 仍会导致系统级错误。常见现象是脚本运行到某个文件突然抛 OSError: [WinError 123] 或 FileNotFoundError —— 实际上是源路径因特殊字符解析失败，而非文件不存在。
- 别用
str.replace()硬删，比如name.replace(":", "_")，它无法处理 Unicode 组合字符（如带重音的 é）、零宽空格（u200b）等隐形字符 - 优先用
re.sub(r'[:"/\|?* - ]', '_', name)清洗非法字符，注意正则中\要双写 - 对 Unicode 字符做标准化：
unicodedata.normalize('NFKD', name)可把 “café” 拆成 “cafe´”，再配合re.sub()剔除组合符
重命名后文件名重复怎么办？
清洗后多个文件可能撞名，比如 "file:name.txt" 和 "file:name?.txt" 都变成 "file_name.txt"。此时 os.rename() 会直接覆盖（Linux/macOS）或报错（Windows），且无提示。
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 用字典记录已生成的目标名，遇到冲突时在文件名后加序号：
base + f"_{i}" + ext - 检查目标路径是否存在：
if os.path.exists(new_path): i += 1，而不是只查new_name - 强烈建议加
--dry-run参数：先打印映射关系（源 → 目标），确认无误再执行重命名
如何安全地批量处理子目录下的文件？
os.walk() 是标准解法，但要注意路径拼接方式 —— 手动拼 root + "/" + file 在 Windows 下会出错（反斜杠冲突），而 os.path.join(root, file) 才可靠。
立即学习“Python免费学习笔记（深入）”；
- 过滤掉目录本身：
if os.path.isfile(full_path):，避免把文件夹当文件重命名 - 跳过隐藏文件（以
.开头）和系统文件（如Thumbs.db、.DS_Store）可减少意外 - 对每个文件单独 try/except：
try: os.rename(old, new) except OSError as e: print(f"Fail {old}: {e}")，防止一个失败中断全部流程
真正麻烦的不是替换字符，而是 Windows 下的保留名（CON、AUX、NUL 等）和长路径限制（默认 260 字符）。这些不会报明显错误，但会导致文件不可见或操作失败。需要额外检测 new_name.upper() in ["CON", "AUX", "NUL", "PRN", "COM1", "LPT1"] 并重写，且启用长路径支持（Windows 10+ 需修改注册表或 pyproject.toml 中设 long_path = true）。
