在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根据成绩分析系统浅析
在本篇文章里小编给大家分享了关于Python根据成绩分析是否继续深造一个系统的相关知识点，有需要的朋友们学习下。
2019-02-02
Python实现AI自动抠图实例解析
这篇文章主要介绍了Python实现AI自动抠图实例解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-03-03
对Python _取log的几种方式小结
今天小编就为大家分享一篇对Python _取log的几种方式小结，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2019-07-07
windows下安装python paramiko模块的代码
windows下安装python paramiko模块，有需要的朋友可以参考下
2013-02-02
Python基于列表list实现的CRUD操作功能示例
这篇文章主要介绍了Python列表list实现的CRUD操作功能,结合实例形式分析了Python基于列表list实现用户数据CRUD相关操作技巧,需要的朋友可以参考下
2018-01-01
使用Python实现PDF文档自动化的操作大全(一键合并、分割、水印、提取与加密解密)
在职场中,PDF文件因其格式稳定、跨平台兼容性好而广泛应用,但你有没有被PDF的这些痛点折磨过：文件零散、编辑受限、合并/分割麻烦和缺乏保护等,这些重复、低效的PDF文件管理任务,严重拖慢了你的办公自动化进程,所以本文介绍了如何使用Python实现PDF文档自动化
2025-11-11
python 实现绘制整齐的表格
今天小编就为大家分享一篇python 实现绘制整齐的表格，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2019-11-11
Python中static相关知识小结
static用法：是一个修饰符，用于修饰成员(成员变量，成员函数).当成员被静态修饰后，就多了一个调用方式，除了可以被对象调用外，还可以直接被类名调用，格式——类名.静态成员。
2018-01-01
python 多种日期时间处理函数实例详解
Python提供了丰富的日期和时间处理函数,可以帮助你轻松地解析、格式化、计算和操作日期和时间,在实际应用中,根据具体需求选择合适的函数,可以提高工作效率并简化代码,本文给大家介绍python多种日期时间处理函数介绍,感兴趣的朋友一起看看吧
2024-03-03
Python实现MySQL错误回滚机制的实战代码
这篇文章主要为大家详细介绍了如何通过Python和PyMySQL实现了一个包含异常回滚机制的转账场景,文中的示例代码讲解详细,感兴趣的小伙伴可以了解一下
2026-01-01