讲师中心 微信公众号
AI工具推荐 视频效率加速

如何为VSCode配置Python的虚拟环境_如何在不同项目间切换解释器【教程】

浅宇吖_4778

浅宇吖_4778

发布时间:2026-01-22 17:22:46

|

860人浏览过

|

来源于php中文网

原创

VSCode 不自动管理 Python 虚拟环境,仅识别已存在解释器路径;需通过“Python: Select Interpreter”选择项目根目录下 venv/.venv/env 中的 python 文件,或手动输入路径,配置保存在 .vscode/settings.json 中且工作区隔离。

如何为vscode配置python的虚拟环境_如何在不同项目间切换解释器【教程】

VSCode 本身不自动管理 Python 虚拟环境,但能识别并切换已存在的解释器路径;关键不是“配置虚拟环境”,而是让 VSCode 正确找到 python 可执行文件(比如 venv/bin/python 或 venv/Scripts/python.exe)。

如何在当前项目中指定 Python 解释器

VSCode 的 Python 解释器选择是工作区级(即每个文件夹独立),不是全局设置。打开项目根目录后:

  • 按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Python: Select Interpreter 并回车
  • 会列出已发现的解释器:系统 Python、conda 环境、以及 VSCode 自动扫描到的 venv / .venv / env 目录下的 python
  • 若没看到你的虚拟环境,说明它没被自动发现——常见原因是没放在项目根目录下,或名字不符合默认扫描规则(如叫 myenv 就不会被扫到)

为什么新建的 venv 没出现在解释器列表里

VSCode 默认只扫描项目根目录下名为 .venv、venv、env 的文件夹。如果你用 python -m venv myenv 创建,它不会被自动识别。

  • 解决办法一:重命名文件夹为 venv 或 .venv
  • 解决办法二:手动添加路径——在 Python: Select Interpreter 菜单底部选 Enter interpreter path...,然后定位到 myenv/bin/python(macOS/Linux)或 myenv\Scripts\python.exe(Windows)
  • 注意:python 文件必须有执行权限(Linux/macOS),否则 VSCode 会报 Permission denied

不同项目间切换解释器是否互相影响

完全隔离。VSCode 把解释器选择保存在工作区配置里(即 .vscode/settings.json 中的 python.defaultInterpreterPath),每个项目有自己的 .vscode 文件夹。关闭一个窗口再打开另一个,解释器自动切换,无需手动干预。

Python Testing
Python Testing

Python 测试速查:运行 pytest、使用 mock/patch、参数化、fixtures、异步、覆盖率测试。

下载

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

  • 例外情况:如果两个项目共用同一个 .vscode 文件夹(比如误把子项目当根目录打开),就会共享设置
  • 检查方式:打开命令面板 → Developer: Toggle Developer Tools → Console 里搜 interpreter,看路径是否符合预期
  • 扩展如 Pylance 和 Python Test Explorer 都依赖这个路径,换错解释器会导致类型提示失效或测试运行失败

推荐的初始化流程(避免后期踩坑)

不是所有项目都需要从 VSCode 里创建 venv,但统一做法能减少混乱:

  • 终端进项目根目录,运行 python -m venv venv(确保用的是你期望的 Python 版本,比如 python3.11 -m venv venv)
  • 激活并安装依赖:source venv/bin/activate(macOS/Linux)或 venv\Scripts\activate(Windows),再 pip install -r requirements.txt
  • 在 VSCode 中打开该文件夹(不是上层父目录),然后调用 Python: Select Interpreter → 选中刚建的 venv/bin/python
  • 此时 .vscode/settings.json 会自动生成,内容类似:
    "python.defaultInterpreterPath": "./venv/bin/python"

路径写成相对形式(./venv/...)比绝对路径更安全,团队协作时其他人也能直接复用。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

1975

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2682

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

916

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2979

2025.09.10

pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2450

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

5663

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

7202

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

3467

2025.07.23

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn