硬编码路径是 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()）不等于测试文件所在目录，也不等于项目根目录。

---

正确获取资源路径的三种可靠方式

• 使用 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 当前位置。

路径不是字符串，是上下文。写错一次，整个测试套件就失去可移植性。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！