如何在Windows和Linux中使用Virtualenv管理Python环境

追风的人
追风的人
发布时间:2026-10-11| 2人浏览过
原创

本文详细介绍在Windows和Linux系统中使用Virtualenv及VirtualenvWrapper创建、切换、查看和管理独立Python环境的完整步骤。通过配置环境变量与核心命令,实现项目依赖隔离,避免包冲突并提升开发效率。

了解工具差异与准备工作

virtualenv 是Python官方的基础虚拟环境管理工具,而 virtualenvwrapper 及其对应平台的扩展(如 virtualenvwrapper-win)提供了更便捷的命令行操作接口。两者结合可大幅简化环境生命周期管理。在开始配置前,请确保已安装Python解释器,并具备系统管理员权限以便修改环境变量或脚本文件。

Windows系统配置步骤

第1步:安装环境管理包

目的:获取虚拟环境核心库及Windows适配脚本。
入口:CMD 或 PowerShell 终端。
动作:执行以下安装命令。

pip install virtualenv virtualenvwrapper virtualenvwrapper-win

第2步:设置虚拟环境统一根目录

目的:指定 virtualenvwrapper 存放所有虚拟环境的固定位置,便于集中管理。
入口:系统高级设置 → 环境变量 → 用户/系统变量 → 新建
动作:添加变量键 WORKON_HOME,值为期望的绝对路径(例如 C:\dev\Envs)。
注意:旧版习惯直接修改 mkvirtualenv.bat 脚本源码。如需沿用该方式,请定位至Python安装目录下的 Scripts/mkvirtualenv.bat(如 C:\Python\Python36\Scripts\mkvirtualenv.bat),找到第24行附近的配置语句:

:defaults
    set "venvwrapper.original_args=%*"
    set "venvwrapper.default_workon_home=%WORKON_HOME%"

完成状态:%USERPROFILE% 被替换为 %WORKON_HOME%,后续创建的环境将自动存入自定义目录。

第3步:执行环境生命周期操作

目的:快速完成环境的创建、激活、切换与销毁。
入口:任意终端窗口。
动作与参数说明:

  • 创建全新环境:mkvirtualenv meiduo
  • 指定Python版本与构建参数:virtualenv -p python3.6 --setuptools 20.2.2 --pip 21.3.1 meiduo
  • 查看已有环境列表:lsvirtualenv 或 workon
  • 切换至目标环境:workon meiduo
  • 删除指定环境:rmvirtualenv meiduo
  • 退出当前环境:deactivate

Linux系统配置步骤

第1步:安装基础组件并确认路径

目的:安装依赖并通过镜像源加速下载。
入口:Terminal
动作:

pip install virtualenv virtualenvwrapper -i https://pypi.tuna.tsinghua.edu.cn/simple

随后定位相关可执行文件路径,用于后续配置文件编写:

find / -name virtualenv       # 通常在 /usr/bin/virtualenv 或类似路径
pwd                          # 打印当前路径,辅助确认脚本位置
which python                 # 复制输出的完整Python解释器路径(如 /usr/local/bin/python3)

第2步:修改Shell配置文件

目的:使环境变量与启动脚本在当前用户会话中永久生效。
入口:vim ~/.bashrc
动作:在文件末尾追加以下内容:

export WORKON_HOME=~/Envs                                    # 设置虚拟环境统一管理目录
mkdir -p ~/Envs                                              # 提前创建物理目录
export VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python3       # 指定底层Python解释器
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS='--no-site-packages' # 生成干净隔绝的环境(新版可能已默认处理,可按需保留)
source /usr/local/bin/virtualenvwrapper.sh                   # 加载wrapper启动脚本

风险提醒:修改配置文件前建议先备份(如 cp ~/.bashrc ~/.bashrc.bak)。
完成状态:执行以下命令后无报错返回。

source ~/.bashrc

第3步:创建与激活独立环境

目的:生成项目级依赖沙盒并完成初始化。
入口:Terminal
动作顺序:

mkdir Myproject
cd Myproject
virtualenv --python=python3 myenv
cd myenv
source bin/activate

验证环境:命令行提示符前出现 (myenv) 标识即表示成功激活。此后安装的第三方库仅影响当前环境。
切换/退出命令同Windows,直接使用 workon myenv 切换,deactivate 退出。

维护建议与排错参考

环境路径迁移:若需更改 WORKON_HOME,请务必同步修改对应平台的脚本引用或 ~/.bashrc 配置,并提前移动旧环境文件夹以防丢失依赖。
版本兼容性:Python 3.3 起内置 venv 模块,轻量项目可直接使用 python -m venv env_name,无需额外安装 virtualenv。
权限校验:Linux下若执行 source bin/activate 报 Permission denied,请检查目录权限或使用 chmod +x bin/activate 修复。

以上就是使用Virtualenv与VirtualenvWrapper管理Python环境的详细内容,更多关于Python开发环境隔离与依赖管理的资料请关注本站其它相关文章!

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。