怎么用virtualenv在指定目录创建Python虚拟环境

在 Python 项目开发与运维过程中，使用 virtualenv 在指定目录创建独立的虚拟环境，是最直接也是最常用的环境隔离方案。只需要在终端中执行 virtualenv <目标目录路径>，virtualenv 就会在指定的路径下自动建立一套包含 Python 解释器、pip 包管理器以及标准库软链接的完整环境。无论是将环境存放在当前项目根目录下便于随项目打包管理，还是存放在集中的存储卷中统一调度，都可以通过精确指定相对路径或绝对路径轻松实现。

一、准备工作：确认与安装 virtualenv

在使用 virtualenv 之前，需要确认系统中已经安装了 Python 以及包管理工具 pip。可以在系统终端（macOS/Linux 的 Terminal 或 Windows 的 CMD/PowerShell）中运行以下命令检查当前环境：

python --version
pip --version

如果尚未安装 virtualenv 工具包，可以通过 pip 进行全局安装：

pip install virtualenv

安装完成后，运行版本检查命令确认工具已经可用：

virtualenv --version

当屏幕输出版本号（如 virtualenv 20.x.x）时，说明 virtualenv 已经就绪，可以开始在指定目录下建立虚拟环境。

二、在指定目录创建虚拟环境的核心方法

virtualenv 的核心语法非常简单，其命令结构为：virtualenv [参数] <目标目录>。其中目标目录既可以是当前工作目录下的相对路径，也可以是跨越盘符或根目录的绝对路径。

1. 使用相对路径在当前项目下创建

在大多数 Web 开发或脚本项目中，常见的规范是将虚拟环境放置在项目根目录中，并命名为 .venv 或 venv。假设当前正位于项目目录 /home/user/my_project 中：

# 进入项目根目录
cd /home/user/my_project

# 在当前目录下创建名为 .venv 的虚拟环境文件夹
virtualenv .venv

命令执行后，当前目录下会生成一个名为 .venv 的文件夹，里面包含全部隔离的运行环境组件。

2. 使用绝对路径在集中目录创建

如果希望将所有项目的虚拟环境统一保存在专用的存储路径下（例如服务器上的统一环境池），可以直接传入完整绝对路径：

# Linux / macOS 绝对路径示例
virtualenv /data/envs/my_special_env

# Windows 绝对路径示例
virtualenv D:\PythonEnvs\my_special_env

如果目标路径中的父级目录已经存在，virtualenv 会自动在该路径下创建最终的目标文件夹；即使目标文件夹尚不存在，virtualenv 也会按需自动创建。

三、指定目录内部生成的文件结构剖析

当命令运行完成后，进入指定的目录，会看到 virtualenv 自动生成的标准目录体系。了解这些目录的职责有助于更好地理解虚拟环境的隔离机制：

• bin / 或 Scripts / 目录：在 macOS 与 Linux 系统下为 bin/，Windows 系统下为 Scripts/。该目录存放着当前虚拟环境专用的 python、pip 可执行程序链接，以及各种 Shell 的环境激活脚本（如 activate、activate.bat、Activate.ps1）。
• lib / 或 Lib / 目录：存放 Python 的核心运行时支持文件，其子目录 lib/pythonX.Y/site-packages/ 是未来所有使用 pip install 安装的第三方依赖包的唯一落脚点。由于该路径完全独立于系统全局目录，从而彻底杜绝了不同项目间的版本冲突。
• pyvenv.cfg 配置文件：该文件包含基础 Python 安装路径（home）、Python 版本以及 include-system-site-packages = false 等关键配置。当虚拟环境的解释器启动时，它通过读取本文件判断自己的运行边界。

四、进阶用法：在指定目录下绑定特定版本的 Python

一台开发机或服务器上常常并存着多个 Python 版本（如 Python 3.9、Python 3.10 与 Python 3.11）。在指定目录创建虚拟环境时，如果直接运行 virtualenv <path>，virtualenv 默认会选用当前运行 virtualenv 本身的那个 Python 解释器。若需指定环境使用特定版本，可使用 -p 或 --python 参数。

1. 按系统已注册的可执行程序名指定

# 指定使用 python3.11 在指定目录创建环境
virtualenv -p python3.11 /data/venvs/proj_py311

2. 按解释器绝对路径精确指定

当系统中有编译安装或非标准路径的 Python 解释器时，直接传入该解释器的绝对执行路径是最稳妥的做法：

# Linux / macOS 指定绝对路径
virtualenv -p /usr/local/bin/python3.10 ./envs/custom_py310

# Windows 指定绝对路径
virtualenv -p C:\Python39\python.exe D:\envs\custom_py39

五、激活与验证新创建的环境

创建成功后，必须通过激活脚本将当前终端会话的环境变量（主要是 PATH）切换到指定目录的虚拟环境，才能正常使用。

1. 执行激活命令

不同操作系统与不同终端环境下，激活脚本的调用方式略有不同：

• Linux / macOS (Bash / Zsh)：

  # 相对路径激活
  source ./my_venv/bin/activate
  
  # 绝对路径激活
  source /data/envs/my_special_env/bin/activate

• Windows (CMD 命令提示符)：

  # 相对路径激活
  my_venv\Scripts\activate.bat
  
  # 绝对路径激活
  D:\PythonEnvs\my_special_env\Scripts\activate.bat

• Windows (PowerShell)：

  # 相对路径激活
  .\my_venv\Scripts\Activate.ps1
  
  # 绝对路径激活
  D:\PythonEnvs\my_special_env\Scripts\Activate.ps1

2. 验证环境生效状态

激活成功后，命令行提示符前方通常会出现 (环境名) 的前缀。可以通过以下命令进一步确认系统当前所调用的 Python 是否确实来自于指定的目录：

# Linux / macOS 查看 Python 路径
which python

# Windows 查看 Python 路径
where python

如果输出的路径正是之前指定的目录（例如 /data/envs/my_special_env/bin/python），说明虚拟环境已经完全接管当前会话。

3. 退出虚拟环境

当工作完成需要返回系统默认环境时，直接在终端中运行以下命令即可：

deactivate

六、常见问题与注意事项

在指定目录创建虚拟环境的过程中，开发者常会遇到一些典型问题，可根据以下要点进行排查：