VSCode与Python虚拟环境(venv/conda)的集成

14次阅读

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

VSCode与Python虚拟环境(venv/conda)的集成

如果您在VSCode中开发Python项目,但无法正确识别或使用虚拟环境,则可能是由于Python解释器路径未正确配置。以下是将VSCode与venv或conda虚拟环境集成的具体操作步骤:

本文运行环境:macBook Pro,macOS Sequoia。

一、通过命令面板选择Python解释器

VSCode通过Python扩展读取并激活指定的虚拟环境解释器路径,该方式适用于venv和conda创建的环境,无需修改工作区设置。

1、确保已安装Python扩展(由microsoft发布)。

立即学习Python免费学习笔记(深入)”;

2、打开包含Python文件的文件夹或工作区。

3、按下Cmd+Shift+Pmacos)调出命令面板。

4、输入“Python: select Interpreter”并回车。

5、在弹出的列表中查找以venv.venvenvanaconda3/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、保存文件后,启动调试时将严格使用该解释器运行目标脚本。

text=ZqhQzanResources