硬编码路径是 pytest 测试失败的根源，因其依赖不可控的执行上下文；应统一以 Path(__file__).parent 或 pytestconfig.rootpath 为基准构建路径，确保跨环境稳定。
test_ 函数里直接写死路径，比如 "./data/test_users.json" 或 "../config/prod.yaml"，不是“能跑就行”，而是埋了个随时会炸的定时器。
硬编码路径导致测试在不同机器、CI环境或重构后立即失效
你本地跑通，CI失败；同事拉代码后报 FileNotFoundError；项目目录一调整，所有用例集体跪倒——这不是运气差，是路径没解耦的必然结果。
pytest 中路径硬编码的典型错误现象
- 运行时报
FileNotFoundError: [Errno 2] No such file or directory: 'tests/data/input.csv' - 同一份代码，在 Windows 上用
"\data\mock.json"能过，Linux/macOS 直接抛异常 -
conftest.py里用os.path.join(os.getcwd(), "fixtures")，但pytest的工作目录随-c或--rootdir变动而变化，结果时灵时不灵
根本问题在于：路径依赖执行上下文，而非代码位置。而 pytest 发现和运行测试时，工作目录（os.getcwd()）不等于测试文件所在目录，也不等于项目根目录。
立即学习“Python免费学习笔记（深入）”；
正确获取资源路径的三种可靠方式
-
使用
pathlib.Path(<strong>file</strong>).parent定位当前测试文件所在目录
提示词大师-python版下载图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- 示例：
fixture_path = Path(<strong>file</strong>).parent / "fixtures" / "user_data.json" - 优势：稳定、跨平台、可链式拼接，
/操作符自动处理分隔符
- 示例：
-
在
conftest.py中统一定义项目根路径（推荐用于全局配置）- 示例：
ROOT_DIR = Path(<strong>file</strong>).parent.parent（假设conftest.py在tests/下） - 后续所有路径基于
ROOT_DIR / "config" / "test.yaml"构建
- 示例：
-
配合
pytest的--rootdir或pytest.ini中的testpaths显式声明根目录，再用pytestconfig.rootpath获取- 示例：
def test_load_config(pytestconfig): config_path = pytestconfig.rootpath / "config" / "base.toml" - 注意：
pytestconfig是 fixture，仅在测试函数参数中可用
- 示例：
别碰 os.getcwd() 和 sys.path[0] ——它们随调用方式不可控。
容易被忽略的细节：相对路径 + cd 命令 = 灾难组合
- 开发者常在 CI 脚本里写
cd tests && pytest，以为这样"./data"就指向tests/data - 实际上
pytest仍以原项目根为基准解析--rootdir，且<strong>file</strong>路径不变，但os.getcwd()已变 - 结果就是：本地手动
cd tests && pytest成功，CI 用完整路径调用却失败
最稳妥的做法只有一条：所有路径计算起点必须锚定在 Python 文件自身（<strong>file</strong>），而不是 shell 当前位置。
路径不是字符串，是上下文。写错一次，整个测试套件就失去可移植性。
