os.path.join拼接路径在macOS正常Windows报错如何解决？

你的os.path.join用法不符合设计规范，才会出现跨平台兼容性问题：

• os.path.join的核心作用就是自动适配不同系统的路径分隔符（macOS/Linux用/，Windows用\），不需要手动拼接斜杠。
• Windows系统的绝对路径会带盘符前缀（比如C:\），os.path.join识别到带盘符的路径段时，会直接将该路径段作为基准拼接后续内容，你手动拼接folder1 + "/" + folder2的写法，当folder2本身是绝对路径时，就会生成类似前半段路径\C:\xxx这种带两个盘符的非法路径，和你报错信息里的路径格式完全吻合，最终触发WinError123语法错误。

1. 修正os.path.join传参方式 #

不要手动拼接任何路径分隔符，直接把所有路径段作为独立参数传入即可，函数会自动适配当前系统的分隔符：

# 错误写法
os.path.join(folder1 + "/" + folder2)
# 正确写法
os.path.join(folder1, folder2)

多层路径拼接可以直接追加参数，比如os.path.join(根目录, 一级子目录, 二级子目录, 文件名)。

2. 优先使用pathlib模块（Python 3.4及以上版本支持） #

Python官方更推荐的面向对象路径处理方案，完全跨平台，写法更简洁不易出错：

from pathlib import Path
# 直接用/运算符拼接，自动适配系统分隔符
full_path = Path(folder1) / folder2

生成的路径对象可以直接调用读写、重命名、判断是否存在等方法，不需要再手动转换为字符串。

验证建议 #

修改代码后可以先打印拼接后的路径，确认格式正常后再执行文件操作，避免异常。

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