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

适用于 windows / macos / linux，含虚拟环境与 conda 环境

1. 准备工作

步骤	操作说明	图示/快捷键
① 打开项目	把文件夹拖进 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 版本字样会立即更新。

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

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

在第 ④ 步选择 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"
}

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

命令面板 → preferences: open user settings (json)

加入：

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

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

场景	操作建议
为每个项目隔离依赖	项目根目录 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 → 步骤同上

新建 hello.py：

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

点击右上角 ▶️ run python file 或 ctrl+alt+n，终端输出路径与状态栏一致即成功。

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

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