Python中两种项目根目录定义语句的差异对比

在Python中定义项目根目录时，Path(__file__).resolve().parent 和 Path('.') 看似都能运行，但核心差异很大，具体如下：

1. 路径基准完全不同 #

• Path('.') 指向当前工作目录（CWD）：也就是你执行Python命令时所在的目录，和脚本本身的位置没有直接关系。比如你在/home/user目录下运行python projects/my_script.py，Path('.')会指向/home/user，而非脚本所在的projects目录。
• Path(__file__).resolve().parent 基于脚本文件的实际位置：__file__是当前脚本的路径，.resolve()会把它转换成绝对路径，.parent取该路径的父目录。不管你从哪个目录启动脚本，这个路径永远指向脚本所在目录的父级，完全不受启动位置影响。

2. 稳定性与可靠性差异 #

• Path('.') 极不稳定：如果用户从不同目录启动脚本，或者IDE的运行配置修改了工作目录，这个路径就会发生变化，很容易导致项目内文件找不到（比如读取配置、资源文件时路径错误）。
• Path(__file__)... 高度可靠：只要脚本文件的位置不改变，无论怎么启动脚本，路径都是固定的。这也是官方技术指南和主流IDE推荐这种写法的核心原因，能避免绝大多数路径相关的bug。

3. 适用场景不同 #

• Path('.') 仅适合极简单脚本项目，且你能确保永远从脚本所在目录启动它。
• Path(__file__)... 适用于所有类型的项目，尤其是多文件模块化项目、需要打包部署的项目，能保证路径一致性，避免跨环境运行时的路径问题。

示例对比 #

假设你的项目结构如下：

my_project/
├── src/
│   └── main.py
└── data/
    └── config.json

• 若在main.py中用Path('.')：当你在my_project目录下运行python src/main.py，Path('.')指向my_project，能正常读取data/config.json；但如果你进入src目录运行python main.py，Path('.')指向src，此时读取data/config.json会直接报错，因为src下没有data文件夹。
• 若在main.py中用Path(__file__).resolve().parent.parent（因为main.py在src下，需要多一层.parent才能指向my_project）：无论你从哪个目录启动脚本，都能精准指向my_project，读取data/config.json永远正常。

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