1. 虚拟环境是什么？

虚拟环境是 Python 为某一个项目单独创建的运行环境。它会在项目目录下生成一个独立的 Python 环境，用来安装该项目需要的第三方库。

例如：

WeatherRoutingTool/
├── .venv/
├── cli.py
├── requirements.txt
└── ...

其中 .venv 就是该项目自己的虚拟环境。

---

2. 使用虚拟环境有什么好处？

使用虚拟环境的主要好处是：

1. 避免依赖冲突
   不同项目可能需要不同版本的库。例如一个项目需要 numpy==1.24，另一个项目需要 numpy==2.0，如果都装在全局 Python 中，很容易冲突。
2. 保持系统 Python 干净
   第三方库只安装在当前项目的 .venv 中，不会污染系统 Python。
3. 方便项目迁移和复现
   可以通过 requirements.txt 记录项目依赖，别人拿到项目后可以快速安装相同环境。
4. 便于 VSCode 识别项目环境
   VSCode 可以为每个项目单独选择解释器，运行和调试时更稳定。

---

3. 如何在 VSCode 项目中创建虚拟环境？

第一步：打开项目文件夹

在 VSCode 中选择：

File → Open Folder

注意：不要只打开某一个 .py 文件，最好打开整个项目文件夹。

---

第二步：打开 VSCode 终端

在 VSCode 中打开终端：

Terminal → New Terminal

或者使用快捷键：

Ctrl + `

确认终端当前路径是项目根目录

---

第三步：创建虚拟环境

推荐使用项目适合的 Python版本创建，比如：

py -3.11 -m venv .venv

如果你的系统中 python 命令已经指向正确版本，也可以使用：

python -m venv .venv

创建完成后，项目目录中会出现：

.venv/

---

4. 如何激活虚拟环境？

Windows PowerShell

.venv\Scripts\activate

激活成功后，终端前面会出现：

(.venv) PS 你的项目路径

Windows CMD

.venv\Scripts\activate.bat

Linux / macOS

source .venv/bin/activate

---

5. 如何让 VSCode 使用这个虚拟环境？

按下：

Ctrl + Shift + P

输入并选择：

Python: Select Interpreter

然后选择项目中的解释器：

.venv\Scripts\python.exe

如果列表中没有出现，可以选择：

Enter interpreter path

然后手动选择：

你的项目路径\.venv\Scripts\python.exe

---

6. 如何检查是否调用成功？

在 VSCode 终端中执行：

python --version

再执行：

where python

如果输出路径类似下面这样，说明 VSCode 已经成功使用项目虚拟环境：

你的项目路径\.venv\Scripts\python.exe

也可以执行：

pip --version

如果路径中包含 .venv，说明第三方库会安装到当前项目虚拟环境中。

---

7. 如何安装项目依赖？

如果项目中有 requirements.txt，执行：

pip install -r requirements.txt

如果项目支持本地安装，也可以执行：

pip install -e .

安装完成后，这些库只会进入当前项目的 .venv，不会影响其他项目。

---

8. 常见问题

问题1：VSCode 显示虚拟环境 broken

可以先测试虚拟环境是否真的可用：

.venv\Scripts\python.exe --version

如果能正常显示版本，例如：

Python 3.11.8

说明虚拟环境本身没坏，可能只是 VSCode 识别异常。可以手动选择解释器：

Python: Select Interpreter → Enter interpreter path

选择：

.venv\Scripts\python.exe

---

问题2：PowerShell 无法激活虚拟环境

如果出现执行策略错误，可以执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

然后重新激活：

.venv\Scripts\activate

---

问题3：想重新创建虚拟环境

可以删除旧环境：

Remove-Item -Recurse -Force .venv

然后重新创建：

py -3.11 -m venv .venv

---

9. 推荐完整流程

# 1. 进入项目根目录
cd F:\pythonscript\WeatherRoutingTool-main

# 2. 创建虚拟环境
py -3.11 -m venv .venv

# 3. 激活虚拟环境
.venv\Scripts\activate

# 4. 检查 Python 路径
where python

# 5. 安装依赖
pip install -r requirements.txt

# 6. 在 VSCode 中选择解释器
# Ctrl + Shift + P → Python: Select Interpreter → .venv\Scripts\python.exe

总结来说，虚拟环境就是给每个 Python 项目单独准备一个独立运行空间。在 VSCode 中使用时，核心步骤就是：打开项目文件夹 → 创建 .venv → 激活环境 → 选择解释器 → 安装依赖。