VSCode不会自动将pip与所选解释器绑定，90%的ModuleNotFoundError源于二者未对齐：选解释器后需重启整个窗口、验证sys.executable路径一致、统一用python -m pip install、检查终端which python输出，并在settings.json中正确配置相对路径的python.defaultInterpreterPath。
VSCode 不会自动把 pip 和你选的解释器绑在一起——选了解释器，不代表 pip install 就装到它身上。90% 的 ModuleNotFoundError 都是因为这两者没对齐。
Python: Select Interpreter 选了但状态栏不更新？
这不是“选了就行”，而是 VSCode 没真正加载新配置。常见现象是点完列表、选中路径，右下角仍显示模糊描述（如 “Python 3.12”）或旧路径。
- 必须关闭并重新打开整个 VS Code 窗口（不是仅关标签页，也不是
Developer: Reload Window） - 确保你打开的是文件夹（
File > Open Folder），不是单个.py文件——只有文件夹才能触发工作区级解释器绑定 - 选完后立刻新建一个
check.py，写入import sys; print(sys.executable)，运行它；输出路径必须和状态栏显示的一致，否则就是假成功
pip install 装了包，但 import 还是报错？
根本原因：你在终端里执行的 pip install 和 VSCode 当前用的解释器不是同一个进程。尤其在虚拟环境里，source venv/bin/activate 只影响当前终端会话，对 VSCode 的调试器、语言服务器、Linter 全无效。
- 统一用
python -m pip install，而不是直接pip install—— 这能强制走当前解释器附带的pip - 确认 VSCode 内置终端也用了同一解释器：打开终端（
Ctrl+`），执行which python（macOS/Linux）或where python（Windows），输出路径必须和状态栏一致 - 检查
pip list和 VSCode 终端里的pip list是否完全一样；不一样就说明环境分裂了
settings.json 里怎么写 python.defaultInterpreterPath？
只靠 UI 点选解释器，重启或换项目就会失效。要固化，就得写进 settings.json，但路径格式极易出错。
立即学习“Python免费学习笔记（深入）”；
- 值必须是相对于当前工作区根目录的路径，不能是绝对路径（除非你明确知道跨平台兼容性风险）
- macOS/Linux：写成
"python.defaultInterpreterPath": "./venv/bin/python" - Windows：写成
"python.defaultInterpreterPath": ".\venv\Scripts\python.exe"（注意双反斜杠或正斜杠都可，但不能混用） - 别写成
"python.defaultInterpreterPath": "python"或"python"——这会让 VSCode 回退到系统默认，失去控制权
调试时 launch.json 里要不要写 "python" 字段？
写了反而坏事。VSCode 调试器默认继承当前选中的解释器，硬编码 "python": "python" 或类似字段，会导致调试器绕过你精心配置的解释器路径。
- 删掉
launch.json中所有显式的"python"字段（如果存在） - 确保
"cwd"设为"${fileDirname}"或"${workspaceFolder}"，否则相对导入会失败 - 如果项目结构复杂（比如
src/myapp/），加"env": {"PYTHONPATH": "${workspaceFolder}/src"}，别指望调试器自己猜
最易被忽略的点：VSCode 的 Python 扩展（ms-python.python）和 Pylance 是集成关系，重复安装 Pylance 反而会冲突；另外，conda 环境必须额外装 debugpy，扩展本身不带这个运行时。
