jenkins中python -m venv venv常报错，根本原因是默认用/bin/sh执行，不支持source和activate语法；正确做法是绕过激活，直接调用.venv/bin/python执行pip和脚本，并确保workspace干净、python路径显式指定。
venv 是 Python 3.3+ 内置的标准方式，但在 Jenkins 流水线中直接用 sh 'python -m venv venv' 很容易失败——不是权限问题，就是路径不一致，或者 shell 解析出错。
为什么 python -m venv venv 在 Jenkins 中常报错？
常见错误现象：OSError: [Errno 2] No such file or directory 或 CommandNotFoundError: Your shell has not been properly configured。根本原因不是 Python 没装，而是 Jenkins 默认用 /bin/sh 执行 sh 步骤，而 source venv/bin/activate 是 bash/zsh 特有语法，在 sh 下直接失效。
- Jenkins agent 启动的 shell 通常是
sh（POSIX 兼容），不支持source或activate脚本中的export链式赋值 -
venv创建成功，但后续pip install执行时仍调用系统全局 Python，因为没真正激活环境 - 不同 agent 节点的 Python 版本可能不一致（比如有的是
python3.9，有的是python3.11），硬写python容易错配
正确做法：绕过 activate，直接调用 venv/bin/python
不用 source，也不依赖 shell 类型——所有 POSIX 兼容 shell 都能执行可执行文件路径。
- 创建环境：
sh 'python3 -m venv .venv'（显式用python3，避免python指向 Python 2） - 安装依赖：
sh '.venv/bin/python -m pip install -r requirements.txt' - 运行测试：
sh '.venv/bin/python -m pytest tests/ --junitxml=test-results.xml' - 如果要用
pytest命令行工具（而非-m pytest），需额外安装到虚拟环境中：.venv/bin/python -m pip install pytest，再用.venv/bin/pytest
agent 选型和 Python 路径必须显式声明
别依赖 agent any 自动找 Python —— 多数 Jenkins agent（尤其是 Linux Docker agent）默认不带 python3，或版本太老。
- 在
pipeline开头加环境检查：sh 'python3 --version'，失败就立刻中断，比后面一堆 pip 报错更早暴露问题 - 推荐固定 agent 标签：
agent { label 'python311' }，并在该节点上预装好python3.11和pip - 若必须兼容多版本，可用
sh 'ls /usr/bin/python3* | tail -n1 | xargs -I {} {} -m venv .venv'（不推荐，仅应急）
清理虚拟环境不能只靠 rm -rf .venv
看似简单，但 Jenkins 的 workspace 可能被多个构建共用（尤其用了 reuseNode true 或未配置 checkout clean），残留的 .venv 会污染下一次构建。
- 务必在
post { always { ... } }里执行清理：sh 'rm -rf .venv' - 更稳妥的做法是把虚拟环境建在
target/或.cache/这类明确用于临时产物的目录下，避免和源码目录混淆 - 如果用了
checkout scm且未设clean: true，Jenkins 不会自动清空 workspace，旧.venv可能还在
实际跑通的关键就三点：不用 source、显式调用 .venv/bin/python、每个构建独占干净 workspace。其它包装（比如封装成函数或 shared library）都是锦上添花，先确保这三步稳了再说。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
