VSCode需手动配置Python解释器路径才能运行调试；先确认系统已安装Python并加入PATH，再通过“Python: Select Interpreter”选择对应路径，确保工作区设置正确且内置终端与解释器一致。
VSCode 本身不自带 Python 运行能力，必须手动配置解释器路径；装了 Python 扩展只是第一步，真正让代码能运行、调试、补全的关键，在于正确关联到本地已安装的 python 可执行文件。
如何确认 Python 已正确安装并被 VSCode 识别
先在终端运行 which python3（macOS/Linux）或 where python（Windows），确保返回一个真实路径，比如 /usr/local/bin/python3 或 C:\Users\Name\AppData\Local\Programs\Python\Python311\python.exe。如果命令报错或无输出，说明系统级 Python 未安装或未加入 PATH —— 此时装扩展也没用。
- Windows 用户常见问题是安装时没勾选
Add Python to PATH - macOS 用 Homebrew 安装的 Python，路径通常是
/opt/homebrew/bin/python3（Apple Silicon）或/usr/local/bin/python3（Intel） - VSCode 的
Python扩展不会自动帮你装 Python，它只负责“找”和“用”
安装 Python 扩展后必须手动选择解释器
装完 Python 扩展（作者：Microsoft），按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Python: Select Interpreter 并回车。此时会列出所有它“猜到”的 Python 环境，包括系统 Python、venv、conda 环境等。
- 如果列表为空，点击
Enter interpreter path...，然后手动粘贴上面查到的完整路径 - 选中后，VSCode 底部状态栏左下角会显示当前解释器路径，例如
Python 3.11.5 ('base': conda)或Python 3.12.1 - 这个选择是工作区（workspace）级的，不同项目可指定不同解释器，配置保存在
.vscode/settings.json中的python.defaultInterpreterPath
为什么写了代码却无法运行或调试
常见现象：按 F5 启动调试报错 ModuleNotFoundError，或右键 Run Python File in Terminal 没反应 —— 很可能是因为当前打开的文件不在解释器能识别的上下文中。
立即学习“Python免费学习笔记（深入）”；
- 确保你打开的是**文件夹**（
File > Open Folder），而不是单个.py文件；否则 VSCode 不知道该用哪个工作区设置 - 检查终端里运行的是否是同一个 Python：在 VSCode 内置终端执行
which python，应与底部状态栏显示的路径一致 - 虚拟环境激活后，必须重启 VSCode 终端（关闭再开），否则旧终端仍用系统 Python
-
launch.json中的python路径如果写死，容易和解释器选择冲突，建议留空，让 VSCode 自动继承
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"module": "test",
"console": "integratedTerminal",
"justMyCode": true
}
]
}
最常被忽略的一点：VSCode 的 Python 扩展依赖 pip 安装的 debugpy。如果解释器里没装它（比如极简版 Python 或某些嵌入式环境），调试功能会静默失效。可以手动运行 python -m pip install debugpy 验证。
