Python 使用 Virtualenv 搭建与管理虚拟环境完整指南

为什么需要独立隔离环境

全局安装的 Python 包会随系统或 IDE 升级而变动，不同项目对同一库的版本要求往往不一致。使用 virtualenv 可以在当前用户目录下生成一套独立的解释器与 site-packages 目录，确保命令执行和 pip 安装包完全局限于指定文件夹内，不污染系统空间。

第1步：确认 Python 环境并安装工具

操作前需确认系统已配置 Python 3.6+ 且 pip 可用。若未自带 virtualenv 模块，可通过以下指令完成安装：

pip install virtualenv

安装完成后，终端输入 virtualenv --version 返回版本号即表示就绪。

第2步：新建项目文件夹并创建虚拟环境

为每个独立任务建立专用目录，避免文件混杂。进入目标工作区后执行创建命令：

mkdir my_project && cd my_project
virtualenv venv

此处将环境命名为 venv。执行完毕后，当前目录下会生成同名子文件夹，内部包含完整的 Python 标准库、pip 及 setuptools 工具链。

第3步：根据系统平台激活环境

激活后命令行提示符前方会显示括号标识，代表后续所有命令均在此沙盒中运行。

• Windows 系统：直接指向 Scripts 子目录下的批处理文件，进入代码块内路径执行即可：

venv\Scripts\activate

• macOS 或 Linux 系统：通过 Shell 调用对应的可执行脚本：

source venv/bin/activate

成功激活后，观察终端左侧出现如 (venv) 的字样，即可开始编写业务代码或调试接口。

第4步：安装第三方库与导出配置清单

此时使用的 pip 已自动切换至虚拟路径。以网络请求库为例进行常规安装：

pip install requests

团队协作时，需将当前环境的所有包及其锁定版本输出为文本文件。打开终端输入：

pip freeze > requirements.txt

生成的 requirements.txt 可直接提交至版本控制系统。其他开发者克隆项目后，只需一条命令即可完成环境复刻：

pip install -r requirements.txt

第5步：暂停工作与清理残留环境

结束编码任务时，释放全局控制台占用：

deactivate

若项目废弃或需要重建空间，请注意虚拟环境本质上仅为普通文件夹集合。删除前请务必确认无未保存的重要配置文件，且终止相关调试进程。风险提示：误删将导致本地缓存的依赖全部丢失，无法直接恢复。确认后直接在所在父级目录移除对应文件夹：

# Windows CMD 下强制删除目录树
rd /s /q venv
# macOS / Linux 下递归清空
rm -rf venv

规范维护建议

• 保持命名一致性：默认推荐统一使用 venv 作为目录名，便于团队成员快速识别。
• 忽略环境快照：务必在根目录的 .gitignore 中加入 venv/ 规则，防止二进制文件膨胀仓库体积。
• 定期校验基线：依托 pip freeze 追踪关键框架迭代，及时对齐线上运行依赖版本。

简要总结

掌握上述流程即可构建纯净的开发底座。从环境初始化到依赖流转，全程无需修改系统级路径变量。以上就是 Python 使用 Virtualenv 进行虚拟环境管理的详细内容，更多关于 Python 环境隔离与包版本控制的资料请关注本站其它相关文章！