使用 Visual Studio Code 创建并激活 Python 虚拟环境

在 Python 开发中，使用虚拟环境（Virtual Environment）能有效隔离不同项目的依赖，避免因包版本冲突导致的开发问题。Visual Studio Code（VS Code）作为主流代码编辑器，提供了便捷的虚拟环境创建与管理功能，以下是更详细的操作指南：

前期准备

在开始前，请确保已在电脑上安装 Python 3.3 及以上版本（推荐 3.6+），并配置好环境变量。可通过终端输入 python --version（Windows）或 python3 --version（macOS/Linux）验证安装是否成功，若显示版本号则说明安装正常。

步骤一：安装 Python 插件

VS Code 的 Python 插件是实现虚拟环境管理的基础，具体安装步骤如下：

1. 打开 VS Code，点击左侧边栏的 扩展图标（或使用快捷键 Ctrl+Shift+X），打开扩展商店。
2. 在搜索框中输入 Python，找到由 Microsoft 官方发布的插件（通常为第一个结果，图标为蓝色 Python 标志）。
3. 点击 安装 按钮，安装完成后建议重启 VS Code 使插件生效。

该插件不仅支持虚拟环境管理，还提供代码补全、语法高亮、调试等核心功能，是 Python 开发的必备工具。

步骤二：创建虚拟环境

1. 打开项目目录：

   • 点击 VS Code 菜单栏的 文件 > 打开文件夹，选择您的项目文件夹；
   • 或在终端导航到项目目录后，输入 code . 直接用 VS Code 打开该目录。

2. 打开终端：

   • 使用快捷键 `Ctrl+Shift+``（反引号，位于键盘左上角）打开终端；
   • 或通过菜单栏 终端 > 新建终端 打开。

3. 创建虚拟环境：

   • 在终端中根据操作系统输入对应命令，创建名为 .venv 的虚拟环境（.venv 是行业常用名称，以点开头为隐藏文件夹，避免误删）：

     • Windows 系统：python -m venv .venv
     • macOS/Linux 系统：python3 -m venv .venv

   • 执行命令后，项目目录下会生成 .venv 文件夹，包含虚拟环境的独立 Python 解释器和依赖库。

步骤三：激活虚拟环境

虚拟环境需激活后才能使用，VS Code 提供了自动激活和手动激活两种方式：

自动激活（推荐）

1. 打开命令面板：使用快捷键 Ctrl+Shift+P 或 F1。
2. 输入并选择 Python: 选择解释器（Python: Select Interpreter）。
3. 在弹出的列表中，找到并选择 .venv 环境：
   • Windows 系统：选择 .venv > Scripts > python.exe
   • macOS/Linux 系统：选择 .venv > bin > python
4. 选择后，VS Code 会自动在终端激活虚拟环境，终端提示符前会显示 (.venv) 标识，表明激活成功。

手动激活（若自动激活失败）

若终端未显示 (.venv)，可手动输入命令激活：

• Windows（Command Prompt 终端）：.\.venv\Scripts\activate.bat
• Windows（PowerShell 终端）：.\.venv\Scripts\Activate.ps1（首次使用可能需要执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 并选择 Y 授权脚本执行）
• macOS/Linux（bash/zsh 终端）：source .venv/bin/activate

步骤四：管理项目依赖

激活虚拟环境后，所有依赖安装都会被限制在 .venv 文件夹中，不影响系统全局环境。

1. 安装依赖：

   • 在终端中使用 pip install <包名> 安装所需依赖，例如：
     • 安装单个包：pip install requests（安装最新版本）
     • 安装指定版本：pip install flask==2.0.1
     • 安装多个包：pip install numpy pandas

2. 导出依赖列表：

   • 当项目开发到一定阶段，建议将依赖导出为 requirements.txt 文件，方便团队协作或部署：

     pip freeze > requirements.txt
     

   • 导出后，requirements.txt 会记录所有依赖的包名和版本，例如 requests==2.31.0。

3. 导入依赖列表：

   • 在新环境（如其他开发者的电脑或服务器）中，可通过以下命令一键安装所有依赖：

     pip install -r requirements.txt
     

步骤五：使用与退出虚拟环境

1. 使用虚拟环境开发：

   • 激活虚拟环境后，VS Code 会自动使用 .venv 中的 Python 解释器运行代码（可在终端输入 python --version 验证，显示的是 .venv 内的版本）。
   • 运行代码时，直接点击代码编辑区右上角的运行按钮，或在终端输入 python 文件名.py 即可。

2. 退出虚拟环境：

   • 在终端中输入 deactivate，终端提示符前的 (.venv) 标识消失，即退出虚拟环境。

补充说明

• 切换虚拟环境：若项目需要切换到其他虚拟环境，重复步骤三中的“选择解释器”操作，选择目标环境即可。
• 删除虚拟环境：直接删除项目目录下的 .venv 文件夹即可（删除后需重新创建）。
• 忽略虚拟环境：在项目的 .gitignore 文件中添加 .venv/，避免将虚拟环境提交到代码仓库（虚拟环境体积较大，且可通过 requirements.txt 重建）。

通过以上步骤，即可在 VS Code 中高效管理 Python 虚拟环境，确保每个项目的依赖独立且可控，大幅减少因版本冲突导致的开发问题。开发时请始终在激活的虚拟环境中安装依赖，保持项目环境的纯净性。