Python 3.15 os.path.isreserved 怎么判断 Windows 保留路径

如果程序要把用户输入保存到 Windows、生成 ZIP 条目，或把文件同步到 Windows 主机，创建前应先检查名称是否属于 Windows 保留路径。Python 3.15 推荐使用 os.path.isreserved(path)：返回 True 只表示这个路径名触碰了当前系统认识的保留规则，并不表示文件已经存在。若程序运行在 Linux 或 macOS、但目标格式是 Windows，应改用 ntpath.isreserved()，不要让宿主机的 os.path 替你决定目标规则。

os.path.isreserved 到底判断什么

os.path.isreserved() 判断的是路径命名规则。Python 3.15 文档把 Windows 上的保留情况归纳为几组：名称末尾是空格或点，包含冒号（例如文件流语法），包含通配符、管道或 ASCII 控制字符，以及 DOS 设备名。CON、NUL、PRN、AUX、COM1 和 LPT1 都应当视为高风险名称；扩展名不会自动让设备名安全，例如 CON.txt 也不适合直接作为普通文件名。

这个 API 不访问磁盘，也不判断路径是否存在。它更像“提交给文件系统前的命名闸门”：适合在拼接输出路径、写入归档条目或接受上传文件名时尽早返回明确错误。官方同时提醒，这是一套对多数 Windows 系统规则的近似，规则可能随 Windows 版本变化，所以不要把它当成永远不变的完整规范。

在 Python 3.15 中怎样检查用户输入

应用层通常不需要自己维护一份设备名黑名单。把原始输入交给 os.path.isreserved()，再把判断结果转换成用户能理解的错误即可。保留原始字符串很重要：清洗后的结果可以用于建议新名称，但不能悄悄覆盖用户输入。

import os

def ensure_windows_name(path_text: str) -> str:
    # 先拒绝 Windows 规则明确不接受的名称，保留原文用于提示。
    if os.path.isreserved(path_text):
        raise ValueError(f"Windows 文件名不可用：{path_text!r}")

    # 这里只返回候选名；真正写入时仍要捕获 OSError。
    return path_text

这里的判断是“可命名性”检查，不等于路径安全检查。若输入来自用户，还要根据业务目录调用 normpath() 或 commonpath() 检查是否越出允许根目录；若要创建文件，则仍需处理权限不足、父目录不存在、文件已存在和网络盘异常。

跨平台生成 Windows 路径时怎么写

os.path 会选择当前 Python 运行平台适用的路径模块。Linux 上它是 posixpath，macOS 上也按 POSIX 规则工作；即使字符串里写着 C:\\，也不会因此变成 Windows 路径判断。需要生成 Windows 归档名或同步清单时，应显式选择 ntpath。

import ntpath

def check_windows_target_name(name: str) -> None:
    # 目标是 Windows 格式，所以固定使用 ntpath 的规则。
    if ntpath.isreserved(name):
        raise ValueError(f"Windows 目标名不可用：{name!r}")

    # 通过词法判断后，交给后续代码拼接目标目录并执行 I/O。

这种写法适合 Linux 构建机生成 Windows 安装包、跨平台备份工具生成 Windows 清单，或服务端先筛选客户端上传名。判断器应绑定“目标路径格式”，而不是绑定“当前运行机器”。

通过 isreserved 后还要检查什么

通过返回值只说明名称没有触碰这组保留规则。生产代码至少保留下面这张清单：

• 格式边界：确认分隔符、盘符、UNC 前缀和相对路径语义符合目标系统。
• 目录边界：把规范化后的候选路径限制在允许根目录内，不能只检查最后一个文件名。
• 资源状态：创建或重命名时捕获 OSError，处理权限、并发冲突、父目录和网络存储错误。
• 兼容版本：Python 3.15 的变更说明已移除 PurePath.is_reserved()，新代码应使用 os.path.isreserved()；部署到旧解释器前先确认 API 可用性。

换句话说，isreserved() 解决的是“这个名字是否明显违反 Windows 命名规则”，不是“这个路径是否可以安全写入”。把它放在命名入口，再把规范化和真实 I/O 错误留给后续层，职责会更清楚。

常见问题

在 Linux 上调用 os.path.isreserved 会按 Windows 规则判断吗？

不会把 POSIX 的 os.path 自动切换成 Windows 模块。目标是 Windows 时直接使用 ntpath.isreserved()，这样判断规则与目标格式一致。

isreserved 返回 False 就一定能创建文件吗？

不一定。它不检查父目录、权限、磁盘状态、路径长度或并发变化；最终创建仍要捕获 OSError 并给出可恢复的处理。

还要继续使用 pathlib.PurePath.is_reserved 吗？

Python 3.15 的变更说明已移除这个旧入口，建议迁移到 os.path.isreserved()。跨平台生成 Windows 路径的程序则明确使用 ntpath.isreserved()。