当直接运行 pytest test_file.py 报错“ModuleNotFoundError”，而 python -m pytest test_file.py 正常时，根本原因在于 Python 的模块导入机制：python -m 自动将当前工作目录加入 sys.path，而独立可执行脚本（如 pytest）不会——这导致自定义模块（如 Library）无法被正确发现。
当直接运行 `pytest test_file.py` 报错“modulenotfounderror”，而 `python -m pytest test_file.py` 正常时，根本原因在于 python 的模块导入机制：`python -m` 自动将当前工作目录加入 `sys.path`，而独立可执行脚本（如 `pytest`）不会——这导致自定义模块（如 `library`）无法被正确发现。
为什么 python -m pytest 能工作，而 pytest 不能？
Python 官方文档明确指出：使用 -m 参数运行模块时（如 python -m pytest），当前工作目录（CWD）会被自动插入到 sys.path 的最前面（参见 Python CLI 文档 -m 选项说明）。这意味着：
- 所有位于项目根目录或子目录下的包（如 Library/、src/、tests/）只要符合 Python 包结构（含 __init__.py 或为 PEP 561 兼容的命名空间包），就能被直接 import；
- pytest 作为安装后的可执行脚本（通常位于虚拟环境 Scripts/pytest.exe 或 bin/pytest），其启动方式等同于普通 Python 脚本执行，不会自动注入当前路径——它仅依赖系统 PYTHONPATH 和已安装的包。
这正是你观察到的现象本质：pip 和 locust 可直接调用，是因为它们对应的命令行入口点（entry point）在安装时已被注册为全局可执行程序，且其内部逻辑不依赖当前路径下的未安装模块；而你的测试代码中 import Library 是对本地开发包的引用，该包尚未安装，因此仅靠 pytest 命令无法定位。
正确解决方案（推荐按优先级排序）
✅ 方案一：以可安装模式（editable install）部署项目（最佳实践）
在项目根目录（含 pyproject.toml 或 setup.py）执行：
pip install -e .
✅ 优势：将当前项目以“开发模式”安装到 Python 环境中，Library 等模块即成为可导入的已安装包，pytest test_file.py 和 IDE 运行均无路径问题。
? 注意：pyproject.toml 中需正确定义 project.dependencies 和 project.optional-dependencies.test（如适用），并确保 Library/ 在 project.packages 或 find: 配置中被包含。
✅ 方案二：显式设置 PYTHONPATH（临时调试用）
在终端中运行前导出路径（Windows PowerShell）：
立即学习“Python免费学习笔记（深入）”；
$env:PYTHONPATH = "$pwd;$(Get-ChildItem -Path . -Directory | ForEach-Object { $_.FullName })"
pytest test_file.py或 Linux/macOS：
export PYTHONPATH="$(pwd):$(find . -type d -name 'Library' | head -n1 | xargs dirname)":$PYTHONPATH pytest test_file.py
⚠️ 不推荐长期使用：易出错、不可移植、CI/CD 中难以维护。
⚠️ 方案三：避免依赖隐式路径，重构导入结构
- 将测试文件置于 tests/ 目录，业务代码置于 src/（pytest 官方推荐布局）；
- 在 pyproject.toml 中配置：
[tool.pytest.ini_options] pythonpath = ["src"]
这样 pytest 会自动将 src/ 加入 sys.path，无需修改环境变量。
❌ 已验证无效的方法（请勿重复尝试）
- 仅添加/删除 __init__.py：不影响 pytest 对未安装包的发现逻辑；
- 创建 .vscode/env 文件设置 PYTHONPATH：VS Code 终端默认不读取该文件（需配合 terminal.integrated.env.* 设置）；
- 修改系统 PATH 添加 Scripts 目录：解决的是“命令未找到”问题，而非“模块找不到”。
补充：验证与诊断技巧
运行以下命令快速确认路径行为差异：
# 查看 python -m pytest 启动时的 sys.path
python -c "import sys; print('
'.join(sys.path))"
# 查看 pytest 命令启动时的 sys.path（需在 pytest 内部打印）
echo "import sys; print('pytest sys.path:', '\n'.join(sys.path))" > debug_path.py
python -m pytest debug_path.py -s
rm debug_path.py? 总结：pytest 命令本身无错，问题本质是 Python 的模块解析规则与工程组织方式的匹配问题。采用 pip install -e . + 标准项目结构，既是 pytest 官方倡导的最佳实践，也是保障团队协作、CI 集成与长期可维护性的基石。
