Python 相对路径为什么会随着运行目录改变

同一段 Python 代码从项目根目录启动时能读到 data/config.json，换成 IDE、定时任务或别的目录启动就报找不到文件，通常不是 open() 随机失效，而是相对路径的起点变了。相对路径默认相对于进程的当前工作目录（current working directory，CWD），不是相对于当前 .py 文件。

项目内固定资源应以 Path(__file__).resolve().parent 为基准；用户在命令行传入的输入输出位置，才适合继续使用 Path.cwd() 或参数中的路径。

相对路径为什么会随着启动目录改变

下面这个写法看起来很明确：

from pathlib import Path

config_path = Path("data") / "config.json"
print(config_path)

它构造的是 data/config.json，并没有声明从哪个项目目录开始。真正调用 read_text()、open() 或 exists() 时，操作系统会按当前进程的工作目录解释它。于是，在项目根目录执行和在 scripts/ 目录执行，可能得到两个不同的目标。

先用下面的诊断信息确认事实：

from pathlib import Path

print("cwd      =", Path.cwd())
print("relative =", Path("data/config.json"))
print("absolute =", Path("data/config.json").absolute())

Path.cwd() 是进程当前目录；它受启动命令、IDE 工作区设置、服务管理器和 os.chdir() 影响。相对路径对象本身只是路径表达式，打印出来并不能证明对应文件已经存在。

项目资源用脚本目录作为稳定基准

如果配置文件和脚本一起部署，通常应从 __file__ 推导基准目录：

from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent
CONFIG_PATH = BASE_DIR / "data" / "config.json"

if not CONFIG_PATH.is_file():
    raise FileNotFoundError(f"配置文件不存在：{CONFIG_PATH}")

config_text = CONFIG_PATH.read_text(encoding="utf-8")

Path 会使用当前操作系统适合的路径形式，斜杠运算符也比手写字符串分隔符更稳妥。resolve() 用于得到规范化的绝对路径；遇到软链接或 .. 时，路径位置会更容易判断。注意这里的基准是脚本所在目录。如果脚本位于 project/scripts/，数据实际放在项目根目录，就应明确写成 BASE_DIR.parent / "data"，不要凭感觉多退一层。

Path.cwd() 和 __file__ 应该怎样分工

两者没有谁永远正确，关键在于路径的所有者是谁：

例如命令行工具可以把用户输入保留为参数，同时只把内置模板固定到代码目录：

import argparse
from pathlib import Path

parser = argparse.ArgumentParser()
parser.add_argument("input", type=Path)
parser.add_argument("--output", type=Path, default=Path.cwd() / "result.json")
args = parser.parse_args()

template = Path(__file__).resolve().parent / "templates" / "item.json"
print("input   =", args.input)
print("output  =", args.output)
print("template=", template)

这样既不会因换目录丢失内置资源，也不会擅自把用户要求的输出文件写回源码目录。

四个输出就能定位大多数路径问题

不要一上来把所有路径改成绝对字符串。先保留计算过程，检查下面四项：

target = Path("data/config.json")
base = Path(__file__).resolve().parent
stable_target = base / target

print("cwd          =", Path.cwd())
print("script_dir   =", base)
print("target       =", stable_target)
print("file_exists  =", stable_target.is_file())

如果 cwd 不符合预期，修正启动配置或使用正确的基准；如果 stable_target 不对，检查脚本和数据目录的相对层级；如果路径正确但 is_file() 为假，再检查部署是否漏文件、大小写、软链接和权限。resolve() 负责路径解析，不会替你创建文件，也不能消除容器挂载或打包资源缺失。

常见问题

为什么把字符串前面加一个斜杠就好了？

那通常是把路径改成了绝对路径，但也可能误指向系统根目录。更稳妥的做法是从明确的项目基准目录拼接，并打印最终结果。

Path(__file__).parent 还需要 resolve() 吗？

简单项目可以工作；需要处理软链接、.. 或希望日志显示明确绝对位置时，使用 resolve() 更容易排查。它不是所有部署环境的万能修复。

为什么 Notebook 里没有 __file__？

Notebook 通常没有脚本文件上下文。请在配置中显式设置项目根目录，或以 Path.cwd() 为起点并让启动目录固定，避免依赖不存在的变量。

记住一条判断即可：资源跟着代码走，就从 __file__ 推导；数据跟着用户当前任务走，就使用参数或 CWD。先打印四个路径事实，再决定修复哪一层。