Python 虚拟环境 venv 创建保姆级教程

1. 建立项目阵地#

首先，我们先创建一个存放代码的文件夹。打开终端或命令行，执行以下操作：

1
mkdir newproject
2
cd newproject

2. 搭建隔离环境#

在 newproject 目录下，我们直接调用 Python 的 venv 模块来初始化环境。我们习惯把这个环境起名叫 .venv，这样它在项目里就是一个隐藏文件夹。

1
# 执行这条命令后，Python 会把一套完整的运行环境拷贝到 .venv 文件夹里
2
python -m venv .venv

3. “进入”我们的虚拟环境#

环境建好了，但我们还没进去。我们需要通过“激活（activate）”脚本，让当前的终端识别这个隔离环境。

• 如果我们在 Windows 平台上：

  • CMD: .venv\Scripts\activate

  • PowerShell: .\.venv\Scripts\Activate.ps1

• 如果我们在 macOS 或 Linux 上：

  1
  source .venv/bin/activate

重点观察： 激活成功后，我们的命令行提示符前会多出一个 (.venv) 字样。这意味着从现在起，我们所有的 pip install 操作都只会影响这个 newproject，而不会动系统全局的 Python。

4. 管理依赖包#

现在我们可以根据需求，在隔离环境里安装不同版本的包了：

• 定向安装： pip install jinja2==2.7

• 导出清单： 当我们把环境配好后，记得运行 pip freeze > requirements.txt。这份清单就是我们项目的“配方”，别人拿到代码后，只需 pip install -r requirements.txt 就能完美复刻我们的环境。

5. 退出与销毁#

当我们忙完 newproject 的活儿，想切换回系统环境或者去干别的，流程也非常简单。

1
deactivate

小结#

venv为应用提供了隔离的Python运行环境，解决了不同应用间安装多版本的冲突问题。