在VS Code中运行Python程序时,正确配置虚拟环境解释器是项目依赖管理的重要环节。以下是如何使用uv工具创建虚拟环境并在VS Code中切换解释器的完整流程:
一、uv虚拟环境创建
-
安装uv工具
pip install uv
-
创建虚拟环境
在项目根目录执行以下命令(以创建名为.venv
的虚拟环境为例):uv venv .venv
- 若需指定Python版本,可添加
--python=3.10
等参数。
- 若需指定Python版本,可添加
-
激活虚拟环境(可选)
- Windows:
.venv\Scripts\activate.ps1
- macOS/Linux:
source .venv/bin/activate
- Windows:
二、VS Code解释器配置
-
打开项目文件夹
在VS Code中打开包含虚拟环境目录(如.venv
)的项目文件夹。 -
选择解释器
- 点击VS Code底部状态栏的Python版本标识(或按
Ctrl+Shift+P
打开命令面板)。 - 输入并选择
Python: Select Interpreter
。 - 从列表中找到
.venv
目录下的解释器路径:- Windows:
项目路径\.venv\Scripts\python.exe
- macOS/Linux:
项目路径/.venv/bin/python
- Windows:
- 点击VS Code底部状态栏的Python版本标识(或按
-
验证配置
- 打开终端(快捷键
Ctrl+`
),检查终端是否自动激活虚拟环境。 - 执行
which python
(macOS/Linux)或Get-Command python
(Windows)确认路径指向.venv
目录。
- 打开终端(快捷键
三、依赖管理与调试
操作 | 命令/步骤 |
---|---|
安装包 | 在终端中执行uv pip install 包名 (使用uv的包管理功能加速安装) |
运行脚本 | 右键编辑器选择Run Python File in Terminal ,或直接在终端输入python 文件名.py |
调试配置 | 点击侧边栏“运行和调试”,创建launch.json 文件,确保"python": "当前虚拟环境路径" |
四、常见问题
-
解释器未列出
- 检查
.venv
目录是否在项目根目录下。 - 手动在VS Code设置(
settings.json
)中添加路径:"python.defaultInterpreterPath": "项目路径/.venv/bin/python"
- 检查
-
终端未激活环境
- 在VS Code设置中启用自动激活:
"python.terminal.activateEnvironment": true
- 在VS Code设置中启用自动激活:
-
uv命令报错
- 更新uv至最新版本:
pip install --upgrade uv
- 更新uv至最新版本:
通过以上步骤,可在VS Code中高效利用uv虚拟环境隔离项目依赖,同时结合VS Code的智能提示和调试功能提升开发效率。