真正纯净的Python测试环境必须从零开始、隔离安装、版本锁定、全程可重现;应使用venv配合pip-tools生成哈希锁文件,禁用缓存与依赖复用,并为多版本测试独立构建环境。

直接在CI/CD里用pip install -r requirements.txt跑测试,等于把本地环境“脏”的那一套原样搬过去——版本漂移、传递依赖失控、缓存污染全都会在流水线里复现。真正纯净的Python测试环境,必须从零开始、隔离安装、版本锁定、全程可重现。
为什么venv + pip install默认行为不等于“纯净”
很多流水线写成先python -m venv .venv,再source .venv/bin/activate && pip install -r requirements.txt,看起来干净,实则埋雷:
-
pip install默认不校验requirements.txt中未声明但已存在的包,旧缓存可能被复用 - 没加
--no-deps或--force-reinstall时,pip会跳过已满足的依赖,导致实际安装树和锁文件不一致 - 没禁用pip缓存(
--no-cache-dir)时,不同job之间可能共享残留的wheel或源码构建产物,行为不可控 - 没指定
--find-links或--index-url时,pip可能从非预期源拉包,尤其在私有镜像场景下容易混源
用pip-tools生成并验证requirements.in → requirements.txt
手动维护requirements.txt几乎必然导致版本漂移。必须让锁文件成为CI流程的输入项,而非人工产物:
- 开发只改
requirements.in(只写直接依赖,如requests==2.31.0或fastapi>=0.115.0) - CI中运行
pip-compile --upgrade --generate-hashes requirements.in -o requirements.txt,强制重算完整依赖树并打哈希 - 紧接着用
pip install --no-deps --no-cache-dir -r requirements.txt装顶层包,再用pip install --no-cache-dir -r requirements.txt装全部(确保传递依赖也被哈希校验) - 加一步
pip check验证无冲突,失败则立刻中断流水线
多Python版本测试必须各自独立构建环境
一个.venv不能跨解释器复用。CI里跑3.9/3.11/3.12三版本测试,不是“切个pyenv再pip install”,而是每个job都该:
将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。
- 用
python3.9 -m venv .venv-py39、python3.11 -m venv .venv-py311等显式创建对应版本虚拟环境 - 每个环境都走一遍完整的
pip install --no-cache-dir -r requirements.txt - 避免用
pyenv local或pyenv shell这类shell状态命令,它们在CI runner里常失效或污染后续job - GitLab CI中用
image: python:3.11-slim比在ubuntu基础镜像上装pyenv更可靠;GitHub Actions直接用actions/setup-python指定版本即可
缓存策略要精确到requirements.txt哈希,而不是整个.venv
缓存.venv目录看似省时间,实则危险:一旦requirements.txt内容变更但哈希没更新(比如注释改了),缓存会被错误复用。正确做法是:
- 只缓存
~/.cache/pip(pip wheel缓存),且key设为pip-${{ hashFiles('requirements.txt') }} - 每次job都重建
.venv,但pip能从缓存快速装wheel,耗时接近冷装却保证纯净 - 禁用
pip install --user或系统site-packages干扰,所有安装必须进当前.venv - 测试结束时用
rm -rf .venv*清理,避免残留影响下一个job(尤其共享runner场景)
最易被忽略的一点:Python版本本身也是环境的一部分。CI配置里写python:3.11不等于“用了3.11”,得在脚本里加python --version和which python双校验——有些基础镜像的python软链可能指向python3.10,而你根本没意识到。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










