如何为VSCode配置Python开发环境，选择合适的解释器并进行调试？

本文共计980个文字，预计阅读时间需要4分钟。

在VS Code中，若要检查系统是否已安装Python，可以使用以下命令：

为什么选了解释器，右下角状态栏还是没变？

这是最常被忽略的“假成功”：你点了 Python: Select Interpreter，选了路径，但状态栏没更新，或者显示的是旧版本。根本原因不是操作失败，而是 VS Code 没真正加载新配置。

• 选完后必须关闭并重新打开整个 VS Code 窗口（不是关标签页，是关窗口再重开）；只刷新或重载窗口（Developer: Reload Window）有时不够
• 确认你打开的是**文件夹**（File > Open Folder），而不是单个 .py 文件——只有打开文件夹，工作区级设置（包括解释器）才会生效
• 如果状态栏仍显示错误路径，打开终端执行 which python（macOS/Linux）或 where python（Windows），把输出路径复制进去，点击 Enter interpreter path… 手动粘贴

调试时 ModuleNotFoundError，但终端里能 import 成功？

调试器和终端用的不是同一个 Python 进程，也不会继承 shell 的激活状态或 PYTHONPATH。你在终端里 source venv/bin/activate 后能跑通，不代表调试器也能。

• 检查 launch.json 中是否写了死的 "python" 字段——删掉它，让 VS Code 自动继承当前选中的解释器
• 确保 "cwd" 设为 "${fileDirname}" 或 "${workspaceFolder}"，否则相对导入（如 from .utils import helper）会失败
• 如果项目有包结构（比如 src/myapp/main.py），在 launch.json 里加 "env": {"PYTHONPATH": "${workspaceFolder}/src"}，别指望调试器自己猜路径
• conda 环境要额外装 debugpy：conda activate myenv && python -m pip install debugpy，扩展本身不带运行时

为什么 launch.json 生成后调试还是报 “No Python interpreter selected”？

这个错误说明 VS Code 根本没读到解释器配置，不是 launch.json 写错了，而是底层环境没搭好。

立即学习“Python免费学习笔记（深入）”；

• 先确认 Python 扩展已安装（ID 是 ms-python.python），且没同时装 Pylance（新版已集成，重复安装反而冲突）
• 检查 .vscode/settings.json 里有没有 "python.defaultInterpreterPath"，如果有，确保值是绝对路径（如 "/Users/name/project/venv/bin/python"），不能是相对路径或变量
• Windows 用户常见问题是安装 Python 时没勾选 Add Python to PATH，导致 VS Code 找不到 python.exe —— 此时必须手动填完整路径，比如 C:\Users\name\AppData\Local\Programs\Python\Python311\python.exe
• Mac 上用 Homebrew 安装的 Python，路径通常是 /opt/homebrew/bin/python3（M1/M2）或 /usr/local/bin/python3（Intel），VS Code 默认可能只搜 python，不搜 python3，所以得手动指定

最易被绕开的一点：VS Code 的集成终端默认不复用你选的解释器环境，即使状态栏显示正确，新开终端仍是系统 shell 默认环境。想让它自动激活虚拟环境，得在终端下拉菜单里手动选中带环境名的选项（如 Python (venv)）——这个选项不会凭空出现，前提是解释器路径指向虚拟环境内的 python 可执行文件，且 VS Code 已成功识别。