Python项目文件路径管理的最佳实践方案咨询

你现在用的os.path.dirname(os.path.realpath(__file__))拼接路径的思路逻辑是对的，核心是锚定脚本自身位置绕开工作目录依赖，本身没有功能性问题，见得少主要是现在有更简洁的标准实现，以及工程化场景下更易维护的方案。

官方推荐的现代写法（Python 3.4+ 全版本支持） #

直接用标准库自带的pathlib模块，比os.path的链式写法更简洁，自动适配Windows/macOS/Linux的路径分隔符，不需要手动处理斜杠、反斜杠差异：

from pathlib import Path

# 获取当前脚本所在的绝对目录，resolve()会自动处理符号链接、路径跳转
script_dir = Path(__file__).resolve().parent
# 用/运算符直接拼接路径，自动解析../层级跳转
data_file = script_dir / "../data/myFile.csv"

# 路径对象可以直接传给open方法
with open(data_file, 'r', encoding='utf-8') as f:
    # 业务逻辑
    pass

• 注意：不要用Path.absolute()替代resolve()，前者不会处理符号链接，也不会标准化路径格式，极端场景会出问题。

中大型项目可维护方案 #

如果项目目录结构固定，不要在每个脚本里反复写../算相对层级，抽成全局路径常量一次定义、全项目复用：

• 在项目根目录新建config.py（或者直接写在项目入口文件里），一次性锚定所有常用路径：

from pathlib import Path

# 锚定项目根目录
PROJECT_ROOT = Path(__file__).resolve().parent
# 预定义资源目录绝对路径
DATA_DIR = PROJECT_ROOT / "data"

• 任意层级的脚本需要访问资源时，直接导入常量即可，不需要关心自己在哪个目录层级：

from config import DATA_DIR

my_file = DATA_DIR / "myFile.csv"

这种写法后续如果调整data目录位置，只需要改config里的一行定义，不需要全局修改所有脚本的路径逻辑，维护成本极低。

现有写法的注意事项 #

你当前的os.path写法没有本质错误，只要注意两个细节就不会出问题：

• 拼接路径必须用os.path.join()，不要直接用字符串拼接，否则跨系统会出现分隔符不匹配的问题
• 如果后续要用pyinstaller之类的工具把脚本打包成可执行文件，__file__会指向打包后的临时解压目录，这时候需要额外加运行环境判断调整锚点逻辑，纯脚本运行场景不需要考虑这个问题。

明确不推荐的写法 #

• 不要用依赖运行工作目录的相对路径，也就是你最早用的open('./../data/myFile.csv')，只要执行python命令的目录变了，路径直接失效
• 不要硬编码写死系统绝对路径，比如open('C:/work/project/data/myFile.csv')，换设备、换部署环境直接报错

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