0

0

VSCode与Python虚拟环境:Conda和venv的最佳实践

P粉986688829

P粉986688829

发布时间:2025-12-26 08:35:21

|

348人浏览过

|

来源于php中文网

原创

VSCode中需手动选择Conda解释器、初始化Conda终端、为venv配置工作区路径及清除Python扩展缓存,以解决虚拟环境识别与激活问题。

vscode与python虚拟环境:conda和venv的最佳实践

如果您在VSCode中开发Python项目,但无法正确识别或激活Conda或venv虚拟环境,则可能是由于环境路径未被VSCode正确检测或配置。以下是实现两者集成的可行操作步骤:

本文运行环境:MacBook Air,macOS Sequoia。

一、在VSCode中手动选择Conda环境

VSCode可通过Python扩展自动发现已安装的Conda环境,但有时需手动指定解释器路径以确保使用正确的环境。该方法适用于Conda环境已创建但未出现在命令面板列表中的情况。

1、打开VSCode,进入任意Python项目文件夹。

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

2、按下 Cmd+Shift+P(macOS)调出命令面板。

3、输入并选择 Python: Select Interpreter

4、在弹出列表中查找以 conda 开头的条目,例如 /opt/anaconda3/envs/myenv/bin/python;若未出现,选择 Enter interpreter path...

5、点击 Find...,导航至Conda环境的 python 可执行文件,通常位于 ~/miniconda3/envs//bin/python~/anaconda3/envs//bin/python

二、通过终端初始化Conda以支持VSCode集成

VSCode内建终端默认不加载Conda初始化脚本,导致 conda activate 命令不可用。启用Shell初始化可使VSCode终端识别Conda命令并正确激活环境。

1、在系统终端中运行 conda init zsh(若使用zsh)或 conda init bash(若使用bash)。

2、关闭并重新打开VSCode,确保新终端会话加载初始化配置。

3、在VSCode集成终端中执行 conda env list,确认环境列表可正常显示。

4、运行 conda activate myenv 激活目标环境。

5、在已激活状态下,再次执行 Python: Select Interpreter,此时应能自动检测到当前激活的Conda环境。

海螺AI
海螺AI

MiniMax平台的AI对话问答工具,你的AI伙伴

下载

三、为venv创建并绑定独立工作区设置

针对使用标准venv的项目,可通过VSCode工作区设置(.vscode/settings.json)强制指定Python解释器路径,避免每次打开项目时重复选择,提升一致性与可复现性。

1、在项目根目录下运行 python -m venv .venv 创建虚拟环境。

2、在VSCode中打开该文件夹,按 Cmd+Shift+P 输入 Preferences: Open Workspace Settings (JSON)

3、在打开的 settings.json 中添加以下内容:

"python.defaultInterpreterPath": "./.venv/bin/python"

4、保存文件后,VSCode将自动使用该路径下的解释器,并在状态栏显示对应环境名称。

5、如需验证,新建一个 test.py 文件,输入 import sys; print(sys.executable),运行后输出路径应指向 ./.venv/bin/python

四、禁用全局Python扩展缓存以解决环境识别延迟

VSCode Python扩展会缓存解释器发现结果,当新增Conda环境或更新venv后,旧缓存可能导致新环境无法立即显示。清除缓存可强制触发重新扫描。

1、关闭所有VSCode窗口。

2、在终端中执行 rm -rf ~/.vscode/extensions/ms-python.python-*/out/client/interpreter(路径根据实际扩展版本微调,通常含 ms-python.python- 前缀)。

3、重新打开VSCode并进入Python项目。

4、再次调用 Python: Select Interpreter,等待几秒后刷新列表。

5、检查是否出现新创建的Conda环境或刚初始化的venv路径。

相关专题

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

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

707

2023.06.15

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

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

625

2023.07.20

python能做什么
python能做什么

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

735

2023.07.25

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

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

616

2023.07.31

python教程
python教程

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

1234

2023.08.03

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

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

547

2023.08.04

python eval
python eval

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

573

2023.08.04

scratch和python区别
scratch和python区别

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

695

2023.08.11

虚拟号码教程汇总
虚拟号码教程汇总

本专题整合了虚拟号码接收验证码相关教程,阅读下面的文章了解更多详细操作。

25

2025.12.25

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.6万人学习

Django 教程
Django 教程

共28课时 | 2.5万人学习

SciPy 教程
SciPy 教程

共10课时 | 0.9万人学习

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

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