pytest-srcpaths并非官方插件，pypi上同名包仅支持pytest 3.x且已废弃；推荐使用pyproject.toml配置pythonpath、--pythonpath参数或conftest.py动态插入路径。
pytest-srcpaths 并不是 pytest 官方插件，也未被主流生态收录 —— 你运行 pip install pytest-srcpaths 会失败，或装上一个无人维护、不兼容新版 pytest 的同名废弃包。
为什么找不到 pytest-srcpaths 插件
这个名称容易让人误以为是 pytest 的标准路径配置机制，但实际：
- pytest 本身不提供名为
pytest-srcpaths的插件或命令行选项 - PyPI 上曾有同名包（
pytest-srcpathsv0.1.0），但仅支持 pytest 3.x，且源码已归档、无更新记录 - 它的功能本质只是简单修改
sys.path，与现代 pytest 的--pythonpath或conftest.py中的sys.path.insert()效果重复，且更不可控
替代方案：用 pytest 内置方式指定源码路径
真正可靠的做法是利用 pytest 原生支持的路径控制机制，按优先级推荐如下：
- 在项目根目录下创建
pyproject.toml，写入：[tool.pytest.ini_options] pythonpath = ["src", "lib"]
（src和lib是相对于该文件的路径） - 或使用
--pythonpath命令行参数：pytest --pythonpath=src --pythonpath=../shared-lib tests/ - 若需动态逻辑（如根据环境切换路径），在项目顶层
conftest.py开头插入：import sys from pathlib import Path sys.path.insert(0, str(Path(__file__).parent / "src"))
注意：pythonpath 影响的是 Python 模块导入路径，不是 pytest 自动发现测试文件的路径 —— 后者由 testpaths 或命令行参数（如 pytest tests/）决定。
常见错误：混淆 import 路径和 test discovery 路径
典型症状是：
- 测试文件能被 pytest 找到并运行，但
import mypackage报ModuleNotFoundError - 手动运行
python -m pytest成功，但用 IDE（如 PyCharm）右键运行单个测试时失败
根本原因：IDE 往往不读取 pyproject.toml 中的 pythonpath，也不会执行 conftest.py 的路径注入。解决办法是：
- 在 IDE 的测试运行配置中显式设置
PYTHONPATH环境变量，值为src:../shared-lib（Linux/macOS）或src;..\shared-lib（Windows） - 避免在
conftest.py里做全局sys.path修改，除非你清楚它会影响所有测试模块的导入行为 - 更健壮的做法是：把源码目录设为可安装包（加
pyproject.toml+build-backend = "setuptools.build_meta"），然后用pip install -e .开发安装
真正的难点不在“怎么加路径”，而在确保路径生效范围覆盖 CLI、CI、IDE 三端一致；很多人卡在 CI 环境里忘了 pip install -e . 或漏配 pythonpath，结果本地跑得通，流水线里 import 就炸。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
