VSCode对Python虚拟环境的支持

10次阅读

vscode需正确配置python解释器以支持虚拟环境:一、通过命令面板选择解释器;二、在设置中配置默认路径;三、用.settings.json声明路径;四、启用自动发现功能并配置venv文件夹名。

VSCode对Python虚拟环境的支持

如果您在VSCode中开发Python项目,但无法正确识别或使用虚拟环境,则可能是由于VSCode未检测到已创建的虚拟环境路径或Python解释器配置不正确。以下是实现VSCode对Python虚拟环境支持的具体操作方式:

本文运行环境:macBook air,macOS Sequoia

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

VSCode通过Python扩展提供的命令面板入口,可手动指定当前工作区所用的Python解释器,从而激活对应虚拟环境中的包与路径。

1、按下 Shift + Command + Pmacos)或 Ctrl + Shift + Pwindows/linux)打开命令面板。

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

2、输入 Python: select Interpreter 并回车。

3、在弹出的列表中查找以 venvenv.venv 结尾的路径项,选择对应虚拟环境下的 python 可执行文件(例如 ./venv/bin/python.venvScriptspython.exe)。

二、在设置中配置Python默认解释器路径

当项目频繁切换虚拟环境或需为多个工作区统一设定解释器时,可通过用户或工作区设置直接写入解释器绝对路径,避免每次重新选择。

1、点击左下角齿轮图标,选择 Settings

2、在搜索框中输入 python.defaultInterpreterPath

3、点击 Edit in settings.json,在json中添加键值对:“python.defaultInterpreterPath”: “./venv/bin/python”(macOS/Linux)或 “python.defaultInterpreterPath”: “.\venv\Scripts\python.exe”windows)。

三、使用 .vscode/settings.json 文件声明解释器

该方式将解释器配置限定于当前工作区,不干扰其他项目,且可随代码一同提交至版本控制,便于团队协作时保持环境一致。

1、在项目根目录下创建 .vscode 文件夹(若不存在)。

2、在该文件夹中新建 settings.json 文件。

3、写入以下内容:{“python.defaultInterpreterPath”: “./venv/bin/python”}(路径需根据实际虚拟环境位置调整)。

四、启用Python扩展的自动环境发现功能

VSCode Python扩展具备扫描项目目录结构的能力,可自动识别常见命名的虚拟环境文件夹,并在状态栏显示当前激活环境。

1、确保已安装官方 Python 扩展(由 microsoft 发布,ID 为 ms-python.python)。

2、在 VSCode 设置中搜索 python.terminal.activateEnvironment,将其设为 true

3、确认设置 python.venvFolders 包含常用虚拟环境路径名,如 [“venv”, “env”, “.venv”, “ENV”]

text=ZqhQzanResources