Python 中的相对路径：终端、IDE 与服务启动
Python 解析相对路径的方式取决于进程的工作目录，而工作目录因启动方式而异。本指南介绍如何检查工作目录、为每种启动场景选择并记录显式路径基准，并说明为何 __file__ 并非总是可靠。
本文内容
简明答案
像 Path("data/config.json") 这样的相对路径是相对于进程的当前工作目录解析的，而不是相对于脚本所在位置。工作目录是解释器启动时 os.getcwd() 报告的值，终端、IDE 和服务启动器通常会设置不同的工作目录。启动时打印 Path.cwd() 以查看实际值。然后有意选择一个显式基准：用户提供的文件使用工作目录，捆绑资源使用 __file__ 的父目录，服务则使用配置的绝对路径。由于 __file__ 是可选属性，某些模块可能未设置，需用 getattr 进行防护。pathlib 的 absolute() 和 resolve() 行为不同：resolve() 会消除 '..' 并跟随符号链接。没有适用于所有环境的通用默认值；请验证每个启动环境，并记录工作目录和解析后的路径。
为什么工作目录决定相对路径
像 data/config.json 这样的路径并非由 Python 本身解释，而是传递给操作系统，由操作系统根据进程的当前工作目录进行解析。该目录在进程启动时设置一次，不会随着脚本移动而改变。pathlib.Path.cwd() 返回一个新的路径对象，表示当前目录，即 os.getcwd() 的返回值。因此，同一个目录在终端中可能产生一种结果，在 IDE 中产生另一种结果，在服务管理器下又产生第三种结果。诊断文件缺失错误的第一步不是猜测脚本位置，而是记录进程实际看到的目录。
import os
from pathlib import Path
# 1. 检查启动器实际设置的内容。
print("cwd:", os.getcwd())
print("cwd path:", Path.cwd())
print("script dir:", Path(__file__).resolve().parent)为每种启动场景选择显式基准
了解工作目录后，有意决定想要使用哪个基准。对于用户提供的输入，工作目录通常是正确的选择，因为用户期望路径相对于他们启动工具的位置。对于随代码一起捆绑的资源，应基于脚本或包位置设置路径。对于长时间运行的服务，最好使用配置的绝对路径，以便服务在进程管理器以任何方式启动时行为一致。在打开文件的代码附近记录所选约定，因为否则未来的维护者会假设脚本位置是默认值。
在 __file__ 可用时谨慎使用
模块的 __file__ 属性可以指向定义当前代码的文件，这使其对于定位捆绑资源很有用。数据模型文档警告说，__file__ 是可选的，某些模块可能未设置，包括静态链接的 C 模块或从非典型来源加载的模块。使用 getattr 防护访问，以免属性缺失时代码引发异常。当 __file__ 存在时，在推导同级路径之前将其解析为绝对形式，因为相对的 __file__ 仍依赖于工作目录。
pathlib 中的 absolute() 与 resolve()
pathlib 提供了两种使路径绝对化的方法，它们并非可以互换。Path.absolute() 使路径绝对化但不进行规范化或解析符号链接，这更接近 os.path.abspath()，但出于安全考虑仍保留 '..' 分量。Path.resolve() 使路径绝对化、消除 '..' 分量并跟随符号链接，这更接近 os.path.realpath()。如果需要现有文件的真实位置，resolve() 通常是更好的选择。如果只需要稳定的绝对形式而不接触文件系统，absolute() 可能更合适。
记录工作目录和解析后的路径
当文件未找到时，同时记录工作目录和你尝试打开的确切路径。这对信息通常比猜测脚本位置更能快速解释失败原因。尽可能包含启动器上下文，例如进程是从终端、IDE 运行配置还是服务管理器启动的。如果路径依赖于配置，也要记录配置值。这些记录使得以后能够重现环境，而不是假设一个通用默认值。
需要验证的常见启动器差异
终端启动通常以 shell 的当前目录开始，可能是项目根目录或你 cd 进入的文件夹。IDE 运行配置可以将工作目录设置为项目根目录、模块文件夹或运行设置中定义的自定义值。服务管理器和容器入口点可能在系统目录或声明的工作目录中启动进程，该目录可能与代码位置不同。由于这些默认值各不相同，请在每个环境中测试实际启动目录，而不是依赖一台机器的行为。
路径敏感代码的实用启动检查
对于早期打开文件的应用程序，添加一个小型启动检查，打印或记录工作目录以及你打算使用的基准路径。如果基准来自 __file__，请验证该属性是否存在并在使用前解析它。如果基准来自配置，请确认配置的路径是绝对的，或者记录它将如何被解释。这种检查在自动化环境中尤其有用，因为启动目录从源代码中不明显。
局限性与版本考量
此处描述的行为取决于进程工作目录以及 __file__ 是否设置，这两者都可能因 Python 实现和启动环境而异。pathlib 的规范化也可能改变路径被其他工具解释的方式，因此 pathlib 并非在所有场景下都是 os.path 的完全无缝替换。一些 pathlib 方法在最近的 Python 版本中发生了变化，包括对符号链接循环和保留路径的更严格处理，因此请在目标运行时上验证行为。当可移植性很重要时，最好使用显式的绝对基准，避免假设相对路径在所有地方的解析方式相同。
检查清单
- 启动时打印 Path.cwd() 或 os.getcwd()，以确认每个启动器的实际工作目录。
- 为相对路径使用显式基准：用户文件使用工作目录，捆绑资源使用 __file__ 的父目录，服务使用配置的绝对路径。
- 使用 getattr 防护 __file__，因为它是可选的，某些模块可能未设置。
- 当需要消除 '..' 并跟随符号链接时选择 pathlib 的 resolve()，当只需要不进行规范化的绝对形式时选择 absolute()。
适用范围
相对路径解析取决于进程工作目录，而工作目录在终端、IDE 和服务启动之间有所不同。__file__ 是可选的，某些模块可能缺失。pathlib 的 absolute() 和 resolve() 行为不同，pathlib 的规范化可能改变路径被其他工具解释的方式。一些 pathlib 行为也在最近的 Python 版本中发生了变化，因此请在目标运行时上验证。