<p>Windows文件名必须移除9个禁用字符： / : * ? " < > |，且禁止使用CON、PRN等保留名，首尾空格和结尾句点会被截断，单文件名不超255字符。</p>
Windows系统下哪些字符必须从文件名中移除
Windows对文件名有硬性限制，:、*、?、"、、<code>>、|、/、 这9个字符在任何位置都不能出现，否则 os.rename 或 open 会直接抛出 OSError: [Errno 22] Invalid argument。注意：. 和空格是合法的（只要不作为结尾），但开头的空格或连续点号（如 ..txt）可能引发其他问题。
用 re.sub 替换非法字符的稳妥写法
别直接写 re.sub(r'[\:*?"|/]', '_', name) —— 在字符串里要转义，正则里又要转义，容易漏掉一层。更安全的是用原始字符串 + 显式列出所有字符：
import re
def sanitize_filename(name):
# 匹配所有Windows非法字符，包括反斜杠和冒号
return re.sub(r'[\/*?:"<>|]', '_', name)
- 用
_替换比删掉更安全：避免产生空文件名或重复名称（如多个???.txt全变成.txt） - 不要用
W（匹配非单词字符）：它会误杀中文、emoji、带重音的字母（如café→caf_） - 如果需兼容Linux/macOS，可额外过滤
/（路径分隔符），但/在Windows非法字符列表里已覆盖
替换后还要处理的边界情况
光过滤非法字符不够，生成的文件名仍可能被系统拒绝：
- 开头或结尾的空格、
.、_：Windows会自动截断，" my_file.txt "实际保存为my_file.txt；建议用name.strip(' ._ ') - 保留字：如
CON、AUX、NUL（不区分大小写），即使加了扩展名也不行；可用白名单校验或统一加下划线后缀（CON.txt→CON_.txt） - 长度超限：NTFS单文件名上限255字符，但Python的
os.path操作在长路径下可能失败；建议提前截断并保留扩展名（name[:200] + ext）
为什么不用 pathlib.Path 自动处理
pathlib 不负责净化文件名，它只做路径拼接和I/O封装。调用 Path("a:b.txt").write_text("x") 依然会报错。有些第三方库（如 python-slugify）默认去除非ASCII字符，不适合保留中文场景。真正可控的方式还是自己用 re.sub 配合少量逻辑判断——核心就两步：先清非法字符，再修边界。
立即学习“Python免费学习笔记（深入）”；
最常被忽略的是保留字检查和首尾空白处理，这两个动作加起来不到三行代码，但能避开80%的“明明改了字符却还是打不开”的问题。
