Python跨不同操作系统读写文件时如何获取统一的有效路径？

核心思路 #

不依赖不稳定的当前工作目录（os.getcwd()），而是通过脚本文件本身的路径（__file__）向上追溯定位项目根目录，自动拼接目标文件的绝对路径，天然适配Windows、macOS等不同系统的路径规则。

具体实现 #

第一步：添加项目根目录锚点（可选） #

在项目根目录（本案例中为python-laborations文件夹）新建一个空的标记文件，命名为.projectroot，作用是让代码可以快速识别项目根目录位置。如果不想额外加文件，也可以直接锚定固定存在的data目录作为识别标记。

第二步：编写路径定位代码 #

使用Python3.4+内置的pathlib库实现，无需安装第三方依赖：

from pathlib import Path

def get_project_root() -> Path:
    # 从当前脚本的绝对路径开始向上追溯
    current_path = Path(__file__).resolve()
    # 最多向上找10级目录，避免无限循环
    for _ in range(10):
        # 有.projectroot标记文件的目录即为项目根
        if (current_path / ".projectroot").exists():
            return current_path
        # 如果不想加标记文件，换成下面这行即可，自动找包含data子目录的根目录
        # if (current_path / "data").is_dir():
        #     return current_path
        current_path = current_path.parent
    raise FileNotFoundError("未找到项目根目录，请确认项目结构完整")

# 调用示例
if __name__ == "__main__":
    root = get_project_root()
    # 拼接目标文件路径，自动适配不同系统的路径分隔符
    tramstops_path = root / "data" / "tramstops.json"
    
    # 读写都直接用这个路径即可，不会出错
    with open(tramstops_path, 'r', encoding="utf-8") as f:
        do_something()

方案优势 #

• 完全不依赖当前工作目录，不管你是在lab1目录还是项目根目录运行脚本，路径都指向正确位置
• 自动适配不同系统的路径分隔符，无需手动处理/和\的差异
• 没有硬编码的目录层级逻辑，后续项目结构调整只要移动标记文件即可兼容
• 读写场景都适用，不会出现写文件时在错误路径生成文件的问题

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