VS Code必须安装Python插件并手动选择解释器才能运行Python代码；若解释器未加入PATH、插件未启用或未正确选择路径，将导致print()等基础功能失效，且调试、语法高亮等功能全部不可用。
VS Code 本身不带 Python 支持，必须装插件 + 手动选解释器，否则 print() 都跑不起来。
Python 解释器没加进 PATH，VS Code 就找不到它
这是新手最常卡住的点：明明安装了 Python，python --version 在终端里能回显，但 VS Code 左下角看不到解释器选项，右键运行提示“command 'python.python' not found”。
- Windows 安装时必须勾选
Add Python to PATH—— 不勾就等于白装 - macOS/Linux 用户如果用
pyenv或conda，要确保 shell 初始化脚本（如~/.zshrc）已加载，且which python输出路径有效 - 验证方式不是只看命令行，还要在 VS Code 终端（
Ctrl+`）里执行python --version；如果失败，说明 PATH 没生效到 VS Code 进程里，需重启 VS Code 或改用系统级安装
Python 插件装了但没激活，Run Python File in Terminal 会消失
微软官方的 Python 插件（ID: ms-python.python）是硬性依赖，但它不会自动启用——得打开一个 .py 文件，或把文件夹设为工作区，插件才会加载语言服务。
- 安装后别急着写代码，先新建一个
test.py，保存，再点击左下角解释器选择项；如果灰掉，说明插件没响应，试试重启 VS Code - 插件启动时会下载
Pylance语言服务器（首次可能耗时 1–2 分钟），状态栏显示“Downloading Python language server…”期间右键菜单不可用，耐心等它变成“Ready” - 如果始终不出现
Run Python File in Terminal，检查是否误装了第三方“Python”命名插件（比如旧版或非微软出品），卸载冲突插件只留ms-python.python
不手动选解释器，VS Code 默认用系统 Python，极易出错
VS Code 不会自动猜你想要哪个 Python 版本，也不会优先用虚拟环境——它默认选第一个找到的，通常是系统自带的 /usr/bin/python（macOS）或低版本 python.exe（Windows），结果就是 pip install requests 装到了错的地方，import numpy 直接报 ModuleNotFoundError。
立即学习“Python免费学习笔记（深入）”；
- 务必按
Ctrl+Shift+P→ 输入Python: Select Interpreter→ 从列表选你刚装的版本（如Python 3.11.9 64-bit） - 如果要用虚拟环境，先在终端执行
python -m venv .venv，再通过上述命令选中.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows） - 选完后，VS Code 会在当前工作区生成
.vscode/settings.json，里面含"python.defaultInterpreterPath"字段——这个路径错了，整个项目就废了
调试配置没生成，F5 启动直接报错
VS Code 的 Python 调试功能不是开箱即用的，必须有 .vscode/launch.json 文件，而它只在你首次点击“运行和调试”侧边栏或按 F5 且当前是 .py 文件时才自动生成。
- 如果按
F5弹出“Please select an environment”，说明还没触发配置生成，先确保文件已保存为.py后缀，且已正确选定解释器 - 生成后默认配置是
"configurations": [{"type": "python", "request": "launch", "module": "test"}]，但实际运行单文件应改为"program": "${file}"，否则会报ModuleNotFoundError - 断点只在解释器选对、文件路径合法、且未被优化（比如没加
-O参数）时才生效；常见坑是调试时终端里手动跑了python script.py，结果发现断点没停——那是你在终端跑的，不是 VS Code 调试器跑的
真正麻烦的从来不是装多少插件，而是每个环节都依赖前一步的精确输出：PATH 决定能不能找到解释器，解释器决定能不能装包，包装在哪决定 import 能不能成功，而所有这些又共同决定调试器能不能 attach 上。漏掉任意一环，错误信息都不会告诉你缺了什么，只会安静地失败。
