0

0

VSCode如何管理Python虚拟环境与依赖包?Anaconda与Pipenv指南【教程】

狼影

狼影

发布时间:2026-01-16 21:56:40

|

667人浏览过

|

来源于php中文网

原创

VSCode需手动指定Python解释器路径才能识别venv或conda环境;必须安装Python扩展,路径须指向python可执行文件而非目录,列表未显示时应手动输入完整路径。

vscode如何管理python虚拟环境与依赖包?anaconda与pipenv指南【教程】

VSCode 识别不到 venvconda 环境?检查 Python 扩展与解释器路径

VSCode 默认不自动加载虚拟环境,必须手动指定解释器。Python 扩展(Microsoft 官方)是前提,没装它,所有环境管理功能都无效。

操作路径:Ctrl+Shift+P → 输入 Python: Select Interpreter → 从列表选中你的环境路径。关键点在于:路径必须指向 python 可执行文件本身,不是目录。

  • venv 路径示例:./venv/bin/pythonmacOS/Linux)或 .\venv\Scripts\python.exe(Windows)
  • conda 环境路径示例:~/anaconda3/envs/myenv/python(macOS/Linux)或 C:\Users\name\Anaconda3\envs\myenv\python.exe(Windows)
  • 如果列表里没出现你的环境,说明 VSCode 没扫描到——此时点击 Enter interpreter path...,手动输入完整路径

pipenv 时 VSCode 不读取 Pipfile?别依赖自动检测

pipenv 的核心是隔离的 virtualenv + Pipfile 锁定依赖,但 VSCode 的 Python 扩展并不解析 Pipfile。它只认解释器路径,不认项目依赖声明。

所以正确流程是两步走:先用命令行激活环境并获取解释器路径,再在 VSCode 中选中它。

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

  • 终端执行 pipenv shell 进入环境后,运行 which python(macOS/Linux)或 where python(Windows),复制输出路径
  • VSCode 中执行 Python: Select InterpreterEnter interpreter path... → 粘贴刚才的路径
  • 注意:pipenv --py 命令可直接输出当前环境的 Python 路径,比 which 更可靠

依赖安装后模块仍报 ModuleNotFoundError?确认 VSCode 正在用对的解释器

这是最常被忽略的问题:你在终端用 pip install requests,但那个终端可能没激活虚拟环境;或者 VSCode 当前选的是系统 Python,而不是你刚创建的 venv

Petalica Paint
Petalica Paint

用AI为你的画自动上色!

下载

验证方法很简单:在 VSCode 内置终端(Ctrl+`)中运行:

python -c "import sys; print(sys.executable)"

输出路径必须和你在 Python: Select Interpreter 中选的一致。如果不一致,说明终端没继承 VSCode 的解释器设置——这时要关掉终端重开,或手动执行 source venv/bin/activate(Linux/macOS)或 venv\Scripts\activate(Windows)。

  • VSCode 终端默认不会自动激活虚拟环境,哪怕你已选了解释器
  • 想让终端自动激活,需在 settings.json 中设 "python.terminal.activateEnvironment": true
  • conda activate myenv 后再开终端,也得确保 VSCode 解释器指向该 conda 环境,否则编辑器和终端用的仍是两个 Python

Anaconda 环境太多,VSCode 列表刷不出来?改用 conda env list 定位路径

VSCode 的解释器选择菜单只会扫描常见路径(如 ~/anaconda3/envs/),但如果你用 conda create -p /path/to/env 指定了自定义路径,它大概率不会出现在列表里。

这时候不能靠“刷新”或“重启”,得主动查:

  • 终端运行 conda env list,看输出中对应环境的绝对路径(最后一列)
  • 路径末尾加上 /python(macOS/Linux)或 \python.exe(Windows)
  • 在 VSCode 中手动输入这个完整路径即可
  • 特别注意:Conda 的 base 环境路径通常是 ~/anaconda3/bin/pythonC:\Users\name\Anaconda3\python.exe,别误选成 conda 自身的可执行文件

复杂点在于,同一个项目可能混用 venvcondapipenv,而 VSCode 不做环境类型判断——它只管解释器路径是否有效。路径错了,语法高亮、调试、智能提示全失效,但错误提示往往很模糊,比如“无法导入模块”或“找不到解释器”,其实只是路径粘错了斜杠或漏了 .exe 后缀。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

755

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

636

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

760

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1263

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

578

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

708

2023.08.11

高德地图升级方法汇总
高德地图升级方法汇总

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

9

2026.01.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.2万人学习

Git 教程
Git 教程

共21课时 | 2.7万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号