VSCode怎么安装Python虚拟环境_VSCode venv和conda配置教程【详解】

P粉328763957

P粉328763957

2026-04-24

472人浏览

原创

vs code 不创建也不管理虚拟环境,仅识别并绑定已创建的环境;python: create environment 命令本质是执行 python -m venv .venv,默认在工作区根目录创建隐藏的 .venv 文件夹,不校验解释器可用性,且终端需启用 python.terminal.activateenvironment 才自动激活。

vscode怎么安装python虚拟环境_vscode venv和conda配置教程【详解】

VSCode 本身不安装、也不管理 Python 虚拟环境——它只负责识别并使用你已创建好的 venvconda 环境。所谓“安装虚拟环境”,其实是两步:先用命令行工具创建,再让 VSCode 找到并绑定那个环境里的 python 可执行文件。

Python: Create Environment 命令到底干了什么?

这个命令是 VSCode Python 扩展提供的快捷入口,本质就是帮你运行 python -m venv .venv(或 conda create),但它有明确限制:

  • 只在当前工作区根目录下创建,不能跨目录指定路径(比如 ../shared-env
  • 默认名称固定为 .venv(Windows/macOS/Linux 一致),不会生成 venvenv
  • 若项目已有 requirements.txt,勾选“Create from requirements.txt”会自动执行 pip install -r requirements.txt,但失败时不中断创建流程
  • 它不校验目标 Python 解释器是否真能运行——如果选了 Python 3.9,但系统里只有 3.11,命令会静默失败,状态栏无提示

为什么选了解释器,终端还是用的系统 Python?

VSCode 的集成终端默认不继承解释器选择结果,必须显式启用自动激活。常见现象是:状态栏显示 Python 3.11 ('.venv': venv),但新开终端里 which python 仍指向 /usr/bin/python3C:Python311python.exe

Python 3.14.2
Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本,属于3.14系列的第二个维护更新。该版本包含了18项修复,重点解决了多进程、数据类及正则表达式等模块的回归问题,并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式(移除GIL)正式获得官方支持,是Python发展的重要里程碑。

下载
  • 打开设置(Ctrl+, ),搜索 python.terminal.activateEnvironment,确保设为 true
  • 该配置需写入工作区(.vscode/settings.json)才对当前项目生效;用户级设置会影响所有项目,容易误激活其他环境
  • Windows PowerShell 用户额外注意:python.terminal.launchArgs 若被设为 ["-NoExit", "-Command", "..."],可能覆盖激活逻辑,建议清空该项
  • 验证方法:新开终端后,检查命令提示符前缀是否出现 (.venv);没有就说明没激活成功

conda 环境路径怎么填才不报错?

VSCode 不支持自动发现 conda 环境,必须手动输入绝对路径,且路径必须精确指向 python 文件本身,不是环境目录。

  • Windows 示例路径:C:UsersAliceminiconda3envsmyprojpython.exe(注意是 python.exe,不是 envsmyproj
  • macOS/Linux 示例路径:/Users/alice/miniconda3/envs/myproj/bin/python
  • 别用 conda activate myproj 后再 which python —— 那个路径可能带 shell wrapper,VSCode 无法调用;应直接查 conda env list 输出中的路径列
  • 如果 conda 安装在 WSL 里,而 VSCode 运行在 Windows,路径必须用 \wsl$Ubuntuhomeliceminiconda3... 格式,不能用 /home/...
  • 选完后立刻在 Python 文件中运行 import sys; print(sys.executable),输出必须和你填的路径完全一致

settings.json 里 python.defaultInterpreterPath 写相对路径还是绝对路径?

必须写**相对于工作区根目录的相对路径**,例如 "./.venv/bin/python",而不是 "/home/alice/project/.venv/bin/python"

  • 绝对路径会导致项目迁移到另一台机器时失效(路径不存在),且团队协作时其他人无法复现
  • VSCode 在执行 Python: Select Interpreter 后自动生成该字段,只要你是从列表里点选的(而非手动粘贴绝对路径),基本不会出错
  • 如果你手动编辑过 settings.json,请确认路径中斜杠方向:Windows 也用 /(VSCode 统一处理),不要写 ,否则解析失败
  • 该配置优先级高于用户级设置,但会被 launch.json 中的 python 字段覆盖——调试时务必检查 launch.json 是否硬编码了错误解释器

最常被忽略的一点:VSCode 的代码补全、Linter、调试器、格式化工具,全部依赖 python.defaultInterpreterPath 指向的解释器所安装的包。哪怕路径对了,如果忘了在对应终端里用 python -m pip install 装包,补全依然会漏、Linter 也会报未定义模块——这不是配置问题,是环境没真正用起来。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

745

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

1155

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

980

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

929

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1432

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1395

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

941

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

839

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

231

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PyCharm官方快速入门指南
PyCharm官方快速入门指南

共0课时 | 0人学习

Python函数定义官方教程
Python函数定义官方教程

共0课时 | 0人学习

Python 3.14.6官方文档
Python 3.14.6官方文档

共0课时 | 0人学习