在VS Code中切换和设置Python解释器的完整指南

更新时间：2026年03月20日 09:22:13 作者：算法小狂人

这篇文章主要为大家详细介绍了在VS Code中切换Python环境的详细方法,支持Windows/macOS/Linux系统及虚拟环境/Conda环境,有需要的小伙伴可以了解下

1. 准备工作

已安装 VS Code 与 Python 扩展（Microsoft 出品）。
已安装目标 Python 版本（系统版、官网版、Anaconda、Miniconda、pyenv 均可）。

2. 快速切换（单项目生效）

步骤	操作说明	图示/快捷键
① 打开项目	把文件夹拖进 VS Code 或 File > Open Folder	—
② 调出命令面板	Ctrl+Shift+P（Win/Linux） Cmd+Shift+P（Mac）	直接使用快捷键
③ 选择解释器	输入 Python: Select Interpreter 并回车
④ 点选目标环境	列表里会显示： • 系统 Python • .venv / venv 虚拟环境 • Conda 环境 • pyenv 版本	带 ★ 的为当前选中项
⑤ 验证	新建终端（Ctrl+`）执行 python -V 或 which python	路径应与所选一致

切换后，VS Code 底部状态栏的 Python 版本字样会立即更新。

此设置仅对当前工作区生效，不会污染全局配置。

3. 手动指定（未自动识别时）

若列表里找不到所需解释器：

在第 ④ 步选择 Enter interpreter path… → Find…

浏览到对应可执行文件：

平台	典型路径示例
Windows	C:\Users\<User>\AppData\Local\Programs\Python\Python311\python.exe
macOS	/usr/local/bin/python3.11 或 ~/.pyenv/versions/3.11.6/bin/python
Linux	/usr/bin/python3.11 或 ~/.local/share/virtualenvs/proj/bin/python

确认后，VS Code 会把该路径写入当前工作区的 .vscode/settings.json：

{
  "python.defaultInterpreterPath": "/absolute/path/to/python"
}

4. 设置默认解释器（全局新窗口生效）

想让每次打开新文件夹都自动使用同一解释器：

命令面板 → Preferences: Open User Settings (JSON)

加入：

"python.defaultInterpreterPath": "/absolute/path/to/python"

注意：如果该工作区已经手动选过解释器，则全局设置会被覆盖。

5. 常用场景速查

场景	操作建议
为每个项目隔离依赖	项目根目录 python -m venv .venv → 激活 → 按第 2 步选 .venv/bin/python
使用 Conda 环境	conda create -n tf213 python=3.9 → 激活 → VS Code 会自动列出，或手动选 Enter interpreter path…
使用 pyenv 多版本	pyenv local 3.10.12 → 重启 VS Code → 解释器列表即出现对应版本
远程/WSL 开发	先在本机 WSL 内安装 Python → VS Code 连接 WSL → 步骤同上

6. 一键验证代码

新建 hello.py：

import sys, platform
print("当前解释器:", sys.executable)
print("版本:", platform.python_version())

点击右上角 ▶️ Run Python File 或 Ctrl+Alt+N，终端输出路径与状态栏一致即成功。

7. 常见问题

问题	解决思路
选完解释器后仍报错 No module named xxx	检查终端提示符前是否有虚拟环境括号，若无，重启 VS Code 或手动激活环境
每次打开都要重新选	把路径写进工作区 .vscode/settings.json 或全局 settings.json
状态栏不显示版本	确认已安装 Python 扩展；若仍不显示，命令面板 → Developer: Reload Window

到此这篇关于在VS Code中切换和设置Python解释器的完整指南的文章就介绍到这了,更多相关VS Code切换和设置Python解释器内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Python Multinomial Naive Bayes多项贝叶斯模型实现原理介绍
这篇文章主要介绍了Python Multinomial Naive Bayes多项贝叶斯模型实现原理，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习吧
2022-09-09
详解如何使用SQLAlchemy连接数据库
这篇文章主要为大家详细介绍了如何使用 SQLAlchemy 连接数据库、建立模型、操作表、以及查询操作表数据等内容,感兴趣的小伙伴可以跟随小编一起学习一下
2023-11-11
Python实现自动化批量提取PDF中的图片
在现代企业的数据工作流中,PDF 文档不仅是文字的载体,往往还沉淀了大量关键的视觉数据,本文将探讨如何利用 Python 深度解析 PDF 页面树,并利用 Spire.PDF for Python 构建一个 PDF 图像提取脚本,希望对大家有所帮助
2026-02-02
Python使用Turtle库绘制一棵西兰花
今天小编就为大家分享一篇Python使用Turtle库绘制一棵西兰花，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2019-11-11
python实现爱奇艺登陆密码RSA加密的方法示例详解
这篇文章主要介绍了python实现爱奇艺登陆的密码RSA加密的方法，本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
2020-05-05
尝试用最短的Python代码来实现服务器和代理服务器
"人生苦短、我用Python",Python最大的特点便是代码简洁,得益于Python自带的wsgiref包和socket模块,这里我们将尝试用最短的Python代码来实现服务器和代理服务器:
2016-06-06
Python读写unicode文件的方法
这篇文章主要介绍了Python读写unicode文件的方法,涉及Python针对文件的读取及编码操作的相关技巧,具有一定参考借鉴价值,需要的朋友可以参考下
2015-07-07
Python文件简单操作及openpyxl操作excel文件详解
这篇文章主要为大家详细介绍了python对文件的简单使用及openpyxl操作excel文件的方法，文中的示例代码讲解详细，感兴趣的小伙伴可以了解一下
2022-10-10
Python3字符串的常用操作方法之修改方法与大小写字母转化
这篇文章主要介绍了Python3字符串的常用操作方法之修改方法与大小写字母转化，文章围绕主题展开详细的内容介绍，具有一定的参考价值，需要的小伙伴可以参考一下
2022-09-09
PyYAML高级用法全揭秘
YAML是一种可读的数据序列化格式,常用于配置文件、数据交换等场景,本文主要介绍了PyYAML高级用法,具有一定的参考价值,感兴趣的可以了解一下
2025-04-04