首先创建并激活虚拟环境,使用 python -m venv venv 创建,再根据系统运行激活命令;随后在vscode中通过命令面板选择“Python: select Interpreter”并指定虚拟环境中的Python解释器;接着在激活环境下用pip安装包,并可导出或安装requirements.txt;最后通过导入包和查看状态栏验证配置。正确设置解释器和激活环境是关键,避免依赖冲突与识别错误。

在 VSCode 中配置 Python 虚拟环境,能有效隔离项目依赖,避免包版本冲突。正确设置后,编辑器会准确识别解释器、自动补全和运行代码。以下是具体操作步骤和注意事项。
创建并激活虚拟环境
Python 自带 venv 模块,可在项目根目录下快速创建独立环境:
python -m venv venv
执行后生成名为 venv 的文件夹(可自定义名称)。接下来需激活环境:
- windows(CMD):venvScriptsactivate
- windows(PowerShell):venvScriptsActivate.ps1
- macOS / linux:source venv/bin/activate
激活成功后,命令行提示符前会显示 (venv) 标记。
立即学习“Python免费学习笔记(深入)”;
在VSCode中选择正确的解释器
打开项目文件夹后,按下 Ctrl+Shift+P 打开命令面板,输入 “Python: Select Interpreter” 并选择。
VSCode 通常能自动发现虚拟环境中的解释器,路径类似:
./venv/bin/python (macos/Linux)
.venvScriptspython.exe (Windows)
若未自动识别,可手动浏览到虚拟环境的 python 可执行文件。
使用pip管理包
确保虚拟环境已激活后,使用 pip 安装所需包:
pip install numpy pandas flask
建议将依赖导出为 requirements.txt,便于协作:
pip freeze > requirements.txt
他人或部署时可通过以下命令一键安装:
pip install -r requirements.txt
验证配置是否生效
新建一个 Python 文件,尝试导入刚安装的包,如:
import numpy as np
print(np.__version__)
如果无报错且能正常运行,说明虚拟环境和包已正确加载。
同时,查看 VSCode 底部状态栏是否显示正确的解释器路径,也是判断依据之一。
基本上就这些。只要解释器选对,虚拟环境激活,包安装到位,VSCode 就能顺畅工作。不复杂但容易忽略细节,比如激活环境或选错解释器,会导致包找不到的问题。