Windows路径转Linux/Mac路径必须用pathlib.PurePath解析再转换，不可简单替换分隔符；需处理盘符、UNC路径、大小写敏感、符号链接等跨平台差异，且动态拼接路径应统一用PurePath.as_posix()。
Windows 路径转 Linux/Mac 路径不能只靠简单替换 \ 为 /，必须用 pathlib 或 os.path 的标准化接口，否则会踩符号链接、大小写敏感、驱动器盘符等坑。
用 pathlib.PurePath 做跨平台路径解析和重建
硬编码字符串拼接或正则替换路径分隔符，在遇到 C:Users
ameDocuments 或 \servershare ile.txt 这类 Windows 特有结构时必然出错。正确做法是先用 PurePath 解析原始路径，再通过其属性（如 .parts、.drive、.anchor）做有意识的转换。
-
PureWindowsPath和PurePosixPath是纯解析类，不依赖当前系统 —— 你可以在 Linux 上安全解析 Windows 路径 - 若需去掉盘符（如把
C:datalog.txt转成/data/log.txt），应显式丢弃.drive，而不是靠.as_posix()直接调用（它在 Windows 上仍保留C:） - UNC 路径（
\hostsharepath）会被识别为.root == '\\'，需单独判断并映射为挂载点（如/mnt/host_share）
避免 os.path.join() 在跨系统脚本中混用
在脚本中动态拼路径时，如果一部分路径来自用户输入（可能是 Windows 格式），另一部分是代码里写的字符串，直接用 os.path.join() 会因当前系统自动插入错误分隔符。例如在 Linux 上运行：os.path.join('C:data', 'output.txt') 得到 C:data/output.txt —— 混合了 和 /，后续 open() 失败。
- 统一改用
pathlib.PurePath(*parts).as_posix()生成斜杠路径（适用于配置输出、URL 构造等场景） - 若最终要实际访问文件，必须用
pathlib.Path（非PurePath），因为它支持.exists()、.resolve()等操作，且能处理符号链接和大小写 - 注意
Path.resolve()在不同系统行为不同：Windows 不区分大小写，Linux 区分；若路径含大小写错误，Linux 下会抛FileNotFoundError
处理环境变量与用户主目录的可移植写法
~ 和 %USERPROFILE% 这类占位符不能靠字符串替换解决，因为 os.path.expanduser('~') 在 Windows 上返回 C:\Users\xxx，而 os.path.expandvars('%USERPROFILE%') 才真正等价；两者在跨平台脚本中行为不一致。
立即学习“Python免费学习笔记（深入）”；
- 始终优先用
pathlib.Path.home()获取当前用户主目录，它比expanduser('~')更可靠，且返回Path对象便于链式操作 - 涉及环境变量（如
$DATADIR或%APPDATA%），先用os.path.expandvars()，再包进PurePath统一处理，避免expandvars后残留反斜杠 - 不要假设
os.sep == '/'—— 即使在 WSL 中，Python 的os.sep仍为'/'，但原生 Windows Python 是'\'；依赖它的逻辑在多平台 CI/CD 中容易失效
最常被忽略的是路径“语义”而非“语法”：比如 C:/a/b/../c 和 /a/b/../c 经过 .resolve() 后结果不同（前者可能受驱动器工作目录影响，后者严格按 POSIX 规则），自动化脚本若没做 .resolve() 或 .absolute() 标准化，下游工具（如 subprocess.run() 调用 rsync 或 tar）很可能静默失败。
