pytest在全局环境运行会因包版本冲突导致静默异常，应使用venv创建隔离环境并配置addopts="--import-mode=importlib"和testpaths避免路径干扰。
为什么 pytest 在全局环境跑会出问题
因为 Python 包版本冲突不是报错，而是静默行为异常。比如你本地装了 requests==2.31.0，但项目要求 requests==2.28.2，pytest 用的却是全局版本——测试通过，上线却 500。这不是 pytest 的锅，是环境没切干净。
常见现象包括：ImportError: cannot import name 'XXX'、AttributeError: module has no attribute 'YYY'，或者测试在 CI 失败、本地却通过。
用 venv 创建隔离环境并安装依赖
别用 virtualenv（老工具），Python 3.3+ 自带 venv，更轻、无额外依赖。
- 进项目根目录，运行：
python -m venv .venv
- 激活环境：
source .venv/bin/activate（macOS/Linux）或.venv\Scripts\activate（Windows） - 只装当前项目所需：先
pip install -e .（如果项目有setup.py或pyproject.toml），再pip install pytest pytest-cov - 确认没混入全局包：
pip list输出里不该出现你没手动装过的包
pytest 配置文件怎么避免“继承”系统路径
pytest.ini 或 pyproject.toml 本身不解决隔离，但能防止误用全局插件。关键在两个配置项：
-
addopts = --import-mode=importlib：强制用 importlib 导入测试模块，绕过sys.path顺序干扰 -
testpaths = tests（或具体目录）：避免 pytest 自动扫描到其他项目下的test_*.py - 如果用了
conftest.py，检查它有没有sys.path.append(...)或硬编码路径——这类代码在虚拟环境中反而容易失效
示例 pyproject.toml 片段：
[tool.pytest.ini_options] addopts = ["--import-mode=importlib", "-v"] testpaths = ["tests"]
CI 中复现本地环境失败的关键点
很多团队在 GitHub Actions / GitLab CI 里用 pip install -r requirements.txt，却忘了加 --no-deps 或没清理缓存，导致旧包残留。
- CI 脚本必须显式创建新环境：
python -m venv .venv && source .venv/bin/activate - 安装时用
pip install --no-cache-dir -e ".[test]"（假设pyproject.toml里定义了[project.optional-dependencies.test]） - 禁止用
pip install pytest单独装——它可能拉取不兼容的 pytest 主版本；应和项目依赖一起解析 - CI 日志里务必检查
which python和python -c "import sys; print(sys.executable)"，确保调用的是虚拟环境里的解释器
最容易被忽略的是：.gitignore 没加 .venv，有人误把本地虚拟环境提交，CI 检出后直接复用，结果环境状态不可控。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
