本教程适用于 Windows、macOS、Linux，使用 VS Code 官方推荐方式创建和管理 Python 虚拟环境（venv）。

一、前置条件

1. 已安装 Python（建议 3.9 及以上）
2. 已安装 VS Code
3. 已安装 VS Code 扩展：Python（微软官方，扩展 ID：ms-python.python）

---

二、推荐方式：使用命令面板创建（最简单）

1. 打开你的项目文件夹（File → Open Folder）
2. 按下快捷键打开命令面板：
   • Windows / Linux：Ctrl + Shift + P
   • macOS：Cmd + Shift + P
3. 输入并选择：

   Python: Create Environment...
   

4. 选择 Venv
5. 选择你想使用的 Python 解释器（一般选系统已安装的 Python）
6. 等待创建完成

创建成功后，项目根目录会出现 .venv 文件夹，VS Code 会自动选中该虚拟环境。

---

三、手动方式：使用终端创建

1. 打开终端

• 快捷键：Ctrl + `（反引号）
• 或菜单：Terminal → New Terminal

2. 创建虚拟环境

Windows：

python -m venv .venv

macOS / Linux：

python3 -m venv .venv

说明：.venv 是文件夹名称，可自定义，但推荐使用 .venv。

3. 激活虚拟环境

Windows（PowerShell）：

.\.venv\Scripts\Activate.ps1

Windows（CMD）：

.venv\Scripts\activate.bat

macOS / Linux：

source .venv/bin/activate

激活成功后，终端提示符前面会出现 (.venv)。

4. 退出虚拟环境

deactivate

---

四、让 VS Code 默认使用该虚拟环境

1. 按 Ctrl + Shift + P（Mac 为 Cmd + Shift + P）
2. 输入并选择：

   Python: Select Interpreter
   

3. 选择带有 .venv 字样的解释器，例如：

   .\.venv\Scripts\python.exe
   

选择后，VS Code 状态栏右下角会显示当前使用的 Python 版本和虚拟环境。

---

五、安装依赖包（示例）

激活虚拟环境后执行：

pip install -r requirements.txt

或单独安装：

pip install requests pandas

---

六、常见问题

问题	解决方法
提示无法运行脚本（PowerShell）	以管理员身份运行 PowerShell，执行 Set-ExecutionPolicy RemoteSigned
找不到 python 命令	使用 python3 或检查 Python 是否加入环境变量
VS Code 没有自动识别虚拟环境	手动执行 Python: Select Interpreter
想删除虚拟环境	直接删除项目下的 .venv 文件夹即可

---

七、最佳实践建议

• 每个项目单独使用一个虚拟环境
• 虚拟环境文件夹命名推荐使用 .venv
• 将 .venv 加入 .gitignore，不要提交到 Git
• 使用 requirements.txt 管理依赖

添加 .gitignore 示例：

.venv/
__pycache__/
*.pyc

---