Hey there! I totally get why absolute paths are a pain—they break the second you move your project to another device. Let's walk through the best ways to set up relative paths in your Python project so everything works smoothly no matter where it's run.

1. 以当前脚本所在目录为基准构建路径 #

这是最常用的场景：如果你的生成文件和脚本在同一个文件夹，或者子文件夹里，先拿到脚本的实际位置，再以此为基础拼接路径。

import os

# 获取当前脚本所在的绝对目录
script_directory = os.path.dirname(os.path.abspath(__file__))
# 拼接相对路径：比如把生成的文件放在脚本同级的output文件夹里
output_file_path = os.path.join(script_directory, "output", "result.txt")

# 写入文件测试
with open(output_file_path, "w") as file:
    file.write("This file uses a relative path that works anywhere!")

这里的__file__指向当前运行的脚本文件，os.path.abspath()把它转成绝对路径，os.path.dirname()提取出它所在的目录。用os.path.join()拼接路径会自动适配Windows、Linux、macOS的路径分隔符，避免手动拼字符串踩坑。

2. 以项目根目录为基准构建路径 #

如果你的项目结构比较复杂（比如有src、data、output等独立文件夹），更推荐以项目根目录为统一基准，这样所有模块的路径逻辑都一致。

比如你的项目根目录下有.git文件夹或者README.md，可以以此为标记找到根目录：

import os

# 从当前脚本所在目录向上查找，直到找到项目根目录（这里以.git文件夹为标记）
current_dir = os.path.dirname(os.path.abspath(__file__))
project_root = current_dir

while not os.path.exists(os.path.join(project_root, ".git")):
    project_root = os.path.dirname(project_root)
    # 防止无限循环，判断是否到了系统根目录
    if project_root == os.path.dirname(project_root):
        raise FileNotFoundError("Couldn't locate the project root directory!")

# 构建根目录下output文件夹的路径
output_report_path = os.path.join(project_root, "output", "project_report.pdf")

如果你的项目结构固定（比如脚本在src文件夹，根目录是src的上一级），也可以直接简化：

project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

3. 用pathlib实现更优雅的路径操作（Python 3.4+推荐） #

pathlib是Python 3.4引入的面向对象路径库，比传统的os.path更直观，代码可读性更高。

from pathlib import Path

# 获取当前脚本所在的目录（resolve()确保是绝对路径）
script_dir = Path(__file__).parent.resolve()
# 用/拼接路径，就像在终端里操作一样
output_file = script_dir / "output" / "user_data.csv"

# 自动创建不存在的文件夹（parents=True会创建多级目录，exist_ok=True避免重复创建报错）
output_file.parent.mkdir(parents=True, exist_ok=True)

# 写入数据
with open(output_file, "w") as file:
    file.write("ID,Username\n1,john_doe\n2,jane_smith")

关键注意事项 #

• 永远不要手动拼接路径字符串：比如别写script_dir + "/output/file.txt"，不同系统的路径分隔符不一样，os.path.join()或者pathlib的/会自动处理这个问题。
• 测试跨设备场景：把项目复制到不同路径、不同操作系统的设备上运行，确认路径逻辑没问题。
• 打包程序时注意路径：如果你的项目要打包成exe或者可执行文件，脚本的实际位置可能会变成临时目录，这时候可以用sys.executable获取可执行文件的路径作为基准。

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