如何用Python确保文件名或路径符合Windows合法性要求？

你遇到的这个问题确实很典型——跨系统共享文件时，Unix/Linux下合法的文件名到Windows就翻车，尤其是那些Windows禁用的特殊字符。pathlib的纯路径对象确实不会自动处理这些非法字符，不过我们有几个简单的办法来解决：

1. 手动定义非法字符并批量替换 #

首先明确Windows文件名禁止的字符：< > : " / \ | ? *，另外文件名也不能以空格或英文句号结尾，还有一些系统保留名称（比如CON、PRN、AUX、NUL这类，哪怕加后缀也不行）。

我们可以写一个简单的函数，把这些非法字符替换成安全的字符（比如下划线_）：

from pathlib import PurePosixPath, PureWindowsPath

def make_windows_safe_path(path):
    # 定义Windows非法字符集合
    invalid_chars = {'<', '>', ':', '"', '/', '\\', '|', '?', '*'}
    # 处理路径的每个部分
    safe_parts = []
    for part in path.parts:
        # 替换非法字符
        safe_part = ''.join(['_' if c in invalid_chars else c for c in part])
        # 处理以空格或点结尾的情况
        safe_part = safe_part.rstrip('. ')
        # 处理系统保留名称
        reserved_names = {'CON', 'PRN', 'AUX', 'NUL', 'COM1', 'COM2', 'COM3', 'COM4', 'COM5', 'COM6', 'COM7', 'COM8', 'COM9', 'LPT1', 'LPT2', 'LPT3', 'LPT4', 'LPT5', 'LPT6', 'LPT7', 'LPT8', 'LPT9'}
        if safe_part.upper() in reserved_names:
            safe_part = f"{safe_part}_"
        safe_parts.append(safe_part)
    # 重新构建路径
    return PureWindowsPath(*safe_parts)

# 测试你的例子
pp = PurePosixPath("foo/bar:baz.txt")
wp = make_windows_safe_path(pp)
print(wp)  # 输出: foo\bar_baz.txt

2. 利用Windows API获取非法字符（需要pywin32） #

如果你能安装pywin32库，可以直接调用Windows系统API获取所有非法文件名字符，这样更准确：

import win32api
from pathlib import PurePosixPath, PureWindowsPath

def make_windows_safe_path(path):
    invalid_chars = set(win32api.GetInvalidFileNameChars())
    safe_parts = []
    for part in path.parts:
        safe_part = ''.join(['_' if c in invalid_chars else c for c in part])
        safe_part = safe_part.rstrip('. ')
        # 同样处理保留名称
        reserved_names = {'CON', 'PRN', 'AUX', 'NUL', 'COM1', 'COM9', 'LPT1', 'LPT9'}
        if safe_part.upper() in reserved_names:
            safe_part = f"{safe_part}_"
        safe_parts.append(safe_part)
    return PureWindowsPath(*safe_parts)

3. 用pathlib检查保留名称 #

pathlib的PureWindowsPath有一个is_reserved()方法，可以检查路径是否是Windows的保留名称，你可以用这个来辅助判断：

wp = PureWindowsPath("CON.txt")
print(wp.is_reserved())  # 输出: True

所以在处理路径时，可以结合这个方法对保留名称做特殊处理，比如加上后缀或者重命名。

这些方法都不需要你有Windows机器就能在Python里运行测试，完全可以在Unix/Linux环境下验证处理后的路径是否符合Windows规范。

内容的提问来源于stack exchange，提问作者wjv