Python如何处理文件名中的非法字符_使用正则进行过滤替换-Python教程-PHP中文网

windows文件名必须移除9个禁用字符： / : * ? " |，且禁止使用con、prn等保留名，首尾空格和结尾句点会被截断，单文件名不超255字符。

python如何处理文件名中的非法字符_使用正则进行过滤替换

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非法字符列表里已覆盖

替换后还要处理的边界情况

光过滤非法字符不够，生成的文件名仍可能被系统拒绝：

python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

开头或结尾的空格、.、_：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 配合少量逻辑判断——核心就两步：先清非法字符，再修边界。

最常被忽略的是保留字检查和首尾空白处理，这两个动作加起来不到三行代码，但能避开80%的“明明改了字符却还是打不开”的问题。