VSCode本身不带Python，必须手动配置本地解释器；90%失败源于路径错误、环境混用或缓存未清理。需先确认终端中python --version有输出，再通过Python: Select Interpreter精确选择可执行文件路径（如.venv/Scripts/python.exe），并配置python.defaultInterpreterPath及重启语言服务。
VSCode 本身不带 Python，必须手动配对本地解释器；配错路径、混用环境、忽略缓存，是 90% 配置失败的根源。
Python 解释器没被 VSCode 识别？先确认终端能跑通
VSCode 不继承 shell 的 PATH，也不自动激活 conda/virtualenv，它只“找”——不是“猜”。
在系统终端（非 VSCode 内置终端）里执行：python --version 或 python3 --version，必须有输出；否则 VSCode 肯定找不到。
Windows 用户重点检查安装时是否勾选了 “Add Python to PATH”；没勾就重装，或手动把类似 C:\Users\me\AppData\Local\Programs\Python\Python312\python.exe 加进系统环境变量。
macOS 用户用 which python3 查路径，优先选 /opt/homebrew/bin/python3（M1/M2）或 /usr/local/bin/python3（Intel），别选 /usr/bin/python3（系统自带，受限且过时）。
Linux 用户确保 python3 和 pip3 都可用，缺就补：sudo apt install python3-pip。
选解释器时路径必须精确到 python.exe 或 python 文件
常见错误是把路径设成虚拟环境目录（如 .venv 或 .venv/Scripts），VSCode 会报 ModuleNotFoundError 或调试断点失效。
正确路径必须指向可执行文件：
• Windows venv：.venv\Scripts\python.exe
• macOS/Linux venv：.venv/bin/python
• conda 环境：~/miniconda3/envs/myproj/python.exe（Windows）或 ~/miniconda3/envs/myproj/bin/python（macOS/Linux）
按 Ctrl+Shift+P 输入 Python: Select Interpreter，列表为空就点 “Enter interpreter path…”，粘贴上面查到的完整路径。
选完后看右下角状态栏是否显示该路径——没变？关掉整个窗口再重开，不是只刷新标签页。
装了包却提示 ModuleNotFoundError？大概率解释器和 pip 不匹配
你运行 pip install requests，但 VSCode 当前解释器是 .venv/bin/python，而 pip 指向的是全局 /usr/bin/pip3，结果包装到了别处。
统一用 python -m pip install：比如在项目根目录终端里运行 ./venv/bin/python -m pip install requests（macOS/Linux）或 .venv\Scripts\python.exe -m pip install requests（Windows）。
虚拟环境务必手动选中：创建 .venv 后，必须用 Python: Select Interpreter 主动挑中它内部的 python，不能依赖自动扫描——VSCode 有时会漏掉非标准路径。
验证是否生效：新建 test.py，写 import sys; print(sys.executable)，运行后输出必须和状态栏显示路径一致。
立即学习“Python免费学习笔记（深入）”；
settings.json 里这三项配置不能靠 GUI 点出来
GUI 设置容易遗漏，尤其在多工作区或远程开发时。直接编辑 settings.json 更可靠：
• "python.defaultInterpreterPath"：填绝对路径或相对路径（如 "./venv/Scripts/python.exe"），值必须和你选中的解释器路径完全一致（大小写、斜杠方向都算）
• "python.terminal.launchArgs"：设为 ["-i"]，让集成终端启动后保持交互态，方便调试完手动查变量
• "python.testing.pytestArgs"：设为 ["--tb=short"]，避免 pytest 默认的长堆栈干扰定位
改完保存，按 Ctrl+Shift+P 运行 Python: Restart Language Server，否则新配置不生效。注意：VSCode 的 Python 扩展会缓存解释器信息，切换环境后不手动重启语言服务，旧缓存仍可能生效。
