VSCode中Python虚拟环境配置有四种方法:一、命令面板选择解释器;二、手动编辑settings.json指定路径;三、终端激活后用code .启动;四、launch.json中配置调试解释器路径。

如果您在VSCode中开发Python项目,但无法正确识别或使用虚拟环境,则可能是由于Python解释器路径未正确配置。以下是将VSCode与venv或conda虚拟环境集成的具体操作步骤:
本文运行环境:MacBook Pro,macOS Sequoia。
一、通过命令面板选择Python解释器
VSCode通过Python扩展读取并激活指定的虚拟环境解释器路径,该方式适用于venv和conda创建的环境,无需修改工作区设置。
1、确保已安装Python扩展(由Microsoft发布)。
立即学习“Python免费学习笔记(深入)”;
2、打开包含Python文件的文件夹或工作区。
3、按下Cmd+Shift+P(macOS)调出命令面板。
4、输入“Python: Select Interpreter”并回车。
5、在弹出的列表中查找以venv、.venv、env或anaconda3/envs/、miniconda3/envs/开头的路径选项。
6、选择对应虚拟环境中的python可执行文件(例如:./venv/bin/python 或 ~/miniconda3/envs/myenv/bin/python)。
二、手动配置settings.json指定解释器路径
当自动发现失败或需为特定工作区固定解释器时,可直接编辑工作区设置文件,强制指定虚拟环境内Python解释器的绝对路径。
1、在VSCode中按下Cmd+, 打开设置界面。
2、点击右上角的“打开设置(JSON)”图标。
3、在settings.json中添加或修改python.defaultInterpreterPath字段。
4、将值设为虚拟环境内Python可执行文件的完整路径,例如:"/Users/username/myproject/.venv/bin/python" 或 "/Users/username/miniconda3/envs/data-science/bin/python"。
5、保存文件后,VSCode会自动重启Python语言服务器并加载该环境的包。
三、使用终端激活后启动VSCode
在终端中预先激活虚拟环境,再从该终端启动VSCode,可使编辑器继承当前shell的PATH和PYTHONPATH,从而默认识别激活环境。
1、打开终端,进入项目根目录。
2、运行source .venv/bin/activate(venv)或conda activate myenv(conda)。
3、确认提示符显示环境名称,且which python返回虚拟环境路径。
4、执行code .命令启动VSCode。
5、此时VSCode内置终端将自动使用已激活的虚拟环境,且Python扩展通常能自动检测到解释器,无需额外选择。
四、配置launch.json调试时使用指定虚拟环境
调试Python脚本时,若需确保断点、变量检查及依赖均来自目标虚拟环境,必须在调试配置中显式声明解释器路径。
1、在项目根目录下打开.vscode/launch.json(如不存在则通过“运行 > 添加配置”生成)。
2、找到或新增一个Python配置对象(type为python)。
3、在该配置中添加"python"字段,并赋值为虚拟环境内Python可执行文件的绝对路径。
4、例如:"python": "/Users/username/project/.venv/bin/python"。
5、保存文件后,启动调试时将严格使用该解释器运行目标脚本。










