virtualenv

创建隔离的 Python 虚拟环境

补充说明

virtualenv 是 venv 的增强替代品，支持更多 Python 版本和更快的创建方式。它的产物是一个目录，激活后 python/pip 指向环境内的副本。

常用示例

virtualenv .venv
virtualenv -p python3.12 .venv
virtualenv --clear .venv
virtualenv --system-site-packages .venv
virtualenv --prompt app .venv
source .venv/bin/activate
deactivate
python -m pip install -r requirements.txt

易错点与排错

• 虚拟环境不能直接移动或重命名；路径写死在脚本里，换位置后要重建。
• --system-site-packages 会引入系统包，容易掩盖未声明的依赖。
• 激活只影响当前 shell；脚本里用 .venv/bin/python 显式调用更可靠。
• Windows 的激活脚本在 Scripts 目录，和 Unix 的 bin 不同。
• 用错解释器会装到全局环境；创建后先确认 which python 和 python -V。
• 环境目录不要提交到仓库；.venv 应加入 .gitignore。
• pip 升级可能影响环境内工具；生产环境锁定版本。
• Python 大版本升级后，旧环境的二进制扩展可能不兼容，需要重建。

相关命令

• python — 解释器与内置 venv
• pip — 安装依赖
• uv — 更快的环境创建