VSCode运行Python需正确配置解释器路径：它只扫描PATH中的可执行python，虚拟环境须手动创建，conda需初始化；调试与终端必须使用同一解释器，通过sys.executable验证；settings.json中python.defaultInterpreterPath应使用工作区相对路径。
VSCode 本身不带 Python 运行能力，装完扩展不等于能跑代码——真正决定 import 能否成功、断点是否命中、pip 包在哪的，是你选的 python 可执行文件路径。配错解释器，90% 的“明明终端能跑，VSCode 报错”问题就来了。
Python: Select Interpreter 列表为空或没你想要的路径
这不是 VSCode 故意不识别，而是它只扫描 $PATH 里有、且文件权限可执行的 python 或 python3。常见原因：
- 系统 Python 没加进 PATH：Windows 安装时漏勾「Add Python to PATH」；macOS 用官网 pkg 安装后未手动添加路径；Linux 某些发行版默认只有
python3，没有python命令别名 - 虚拟环境还没创建：VSCode 不会替你运行
python -m venv venv，必须先在终端手动建好，再刷新列表 - Conda 环境未初始化：conda 安装后需先运行
conda init bash（或对应 shell），否则 VSCode 启动时读不到 conda 的 PATH 注入
实操建议：先在 VSCode 内置终端（Ctrl+`）里执行 which python3（macOS/Linux）或 where python（Windows），复制输出的完整路径；然后在命令面板输入 Python: Select Interpreter → 点击 Enter interpreter path → 粘贴进去。
选对了解释器，但 import 还是报 ModuleNotFoundError
根本原因是：VSCode 的调试器、语言服务器、终端三者用的不是同一个 Python 实例。即使底部状态栏显示路径正确，也可能只是 UI 缓存。
立即学习“Python免费学习笔记（深入）”；
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 检查内置终端是否同步：在终端里执行
python -c "import sys; print(sys.executable)"，输出必须和状态栏一致 - 不要手动
source venv/bin/activate：这仅影响当前终端 session，对调试器无效；VSCode 要的是直接指向venv/bin/python的硬路径 -
launch.json里别写死"python": "./venv/bin/python"：留空即可，VSCode 会自动继承当前工作区设置；写死反而容易和解释器选择冲突
验证方式：新建 test.py，写 import sys; print(sys.executable)，右键「Run Python File in Terminal」，看输出是否匹配你选的路径。
settings.json 里 python.defaultInterpreterPath 怎么写才可靠
这个配置才是真正固化解释器的关键，但它极易因路径写法出错而失效。
- 必须用相对路径：例如
"./venv/bin/python"（macOS/Linux）或".\venv\Scripts\python.exe"（Windows），不能用~/venv/bin/python或绝对路径 - 路径起点是工作区根目录：即你通过「File > Open Folder」打开的那个文件夹，不是 .vscode 所在目录
- 虚拟环境路径要真实存在：如果删过
venv文件夹但没重选解释器，VSCode 仍会尝试调用已不存在的路径，导致所有功能静默失败
推荐做法：先用 UI 选一次解释器，让 VSCode 自动生成 .vscode/settings.json；再手动打开该文件，确认 python.defaultInterpreterPath 字段值是否符合上述规则——比手敲更少出错。
调试时断点不触发、变量看不到
这几乎全是 launch.json 配置缺失或错位导致，不是扩展没装好。
- 必须确保
"type": "python"和"request": "launch"同时存在，缺一不可 - 如果脚本依赖同目录下的模块，一定要加
"cwd": "${fileDirname}"，否则 Python 无法把当前文件所在目录加入sys.path - 传参要用
"args": ["--input", "data.txt"]，不是拼在"program"后面；参数里含空格或特殊字符时，数组形式才能正确解析
最简验证配置：
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"module": "pytest",
"console": "integratedTerminal",
"justMyCode": true,
"cwd": "${fileDirname}"
}
]
}删掉所有多余字段，从这个干净模板开始调。
真正卡住人的从来不是“怎么装”，而是路径是否对齐、配置是否生效、终端与调试器是否用同一套环境——这些细节一旦错位，错误现象就高度随机，排查成本远高于预防成本。
