Windows 限制多种特殊字符及保留名，Linux 仅禁 和 /，跨平台需统一过滤重命名策略，兼顾非法字符、保留名、长度及路径安全。
Windows 和 Linux 对文件名的限制到底差在哪？
Windows 禁止 :、*、?、"、<、>、|、、/，还不能以空格或点结尾；Linux 只禁止 （空字符）和 /。但跨平台时真正要防的不是“绝对非法”，而是“可能出事”——比如 CON、AUX 这类 Windows 保留名，或者 macOS 的 .DS_Store 冲突风险。
所以别只盯着 ASCII 特殊符号，得统一过滤+重命名策略。
- 用
os.path.basename()提取原始文件名，避免路径注入 - 不要简单删掉非法字符（比如把
a?b.txt变成ab.txt，可能撞名），建议替换为下划线_ - 保留名检查必须在替换后做：比如
CON.txt→_CON_.txt→ 再检查是否等于CON（忽略扩展名）
用 pathlib + 正则预处理最稳妥
Python 3.4+ 的 pathlib 比 os 更语义化，配合正则能一次覆盖多数边界情况。关键不是写最短代码，而是让规则可读、可维护。
import re
from pathlib import Path
<p>def sanitize_filename(name: str) -> str:</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill8551" title="Claw Code Suite (Python-Only Edition)"><img
src="https://img.php.cn/upload/skill/000/000/081/179212160094080.jpg" alt="Claw Code Suite (Python-Only Edition)" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill8551" title="Claw Code Suite (Python-Only Edition)">Claw Code Suite (Python-Only Edition)</a>
<p>仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...</p>
</div>
<a href="/xiazai/skill8551" title="Claw Code Suite (Python-Only Edition)" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>替换所有控制字符和非法符号（除 - _ . 以外）</h1><pre class='brush:python;toolbar:false;'>name = re.sub(r'[^w-_. ]', '_', name)
# 去首尾空格和点
name = name.strip().rstrip('.')
# Windows 保留名（不区分大小写）
reserved = {'CON', 'PRN', 'AUX', 'NUL', 'COM1', 'COM2', 'COM3', 'COM4',
'COM5', 'COM6', 'COM7', 'COM8', 'COM9', 'LPT1', 'LPT2', 'LPT3',
'LPT4', 'LPT5', 'LPT6', 'LPT7', 'LPT8', 'LPT9'}
stem = Path(name).stem.upper()
if stem in reserved:
name = f"_{name}"
return name注意：w 在非 ASCII 字符（如中文）下默认不匹配，如果需支持 Unicode 文件名，改用 re.sub(r'[^u4e00-u9fa5w-_. ]', '_', name) 或更宽松的 re.sub(r'[ - \/:*?"<>|]', '_', name)。
shutil.move 之前必须验证目标路径是否存在冲突
即使文件名已清洗，仍可能因大小写敏感性（Linux/macOS）或长文件名截断（Windows FAT32）导致意外覆盖。比如 Report_v1.txt 和 report_V1.TXT 在 Windows 上是同一个文件，但在 Linux 上不是。
- 用
Path(target).exists()检查前，先调用target.resolve()避免符号链接干扰 - 若目标已存在，不要静默覆盖——至少加个
if not target.exists() or force:开关 - 特别注意
shutil.move()在跨文件系统时实际是 copy+unlink，失败后原文件可能已删，务必加try/except回滚逻辑
上传场景下，用户传来的文件名更要防“看起来合法但实际危险”
Web 表单里用户提交的 ../../etc/passwd 或 shell.php%00.jpg 不是文件名问题，是路径遍历和 null byte 注入。这时候 sanitize_filename() 必须配合白名单校验。
- 永远用
Path(safe_name).name获取纯文件名，丢弃用户传入的任何路径成分 - 对扩展名单独校验：
suffix.lower() in {'.txt', '.pdf', '.jpg'}，别信content-type - 生成最终路径时，用
safe_dir / safe_name拼接，而非字符串格式化 - 如果框架支持（如 Flask 的
secure_filename()），优先用它，但它不处理保留名，仍需额外检查
最易被忽略的是：清洗后的文件名长度。Windows 路径总长限制 260 字符，但 Python 默认开启长路径支持（\? 前缀），而很多旧工具不认。建议硬性限制总路径（含目录）≤ 200 字符，并在日志里记录截断行为。
