VS Code需手动指定Python解释器路径，否则可能调用系统默认版本导致pip包不可见、调试失败或import报错；应通过命令行获取正确路径，在VS Code中选择对应解释器并验证sys.executable一致。
VS Code 本身不自带 Python 运行环境，必须手动指定已安装的 Python 解释器路径；否则 python 命令可能调用系统默认版本（比如 macOS 的 /usr/bin/python3），导致 pip install 包不可见、调试失败或 import 报错。
如何确认并选择正确的 Python 解释器
VS Code 的 Python 扩展依赖 python.defaultInterpreterPath 或工作区级设置来定位解释器。常见错误是选了虚拟环境外的全局 Python，或选了没装 pip 的精简版（如某些 Linux 发行版的 python3-minimal）。
- 终端中运行
which python3（macOS/Linux）或where python（Windows），记下完整路径，例如/opt/homebrew/bin/python3或C:\Users\name\AppData\Local\Programs\Python\Python311\python.exe - 在 VS Code 中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Python: Select Interpreter - 若列表里没有目标解释器，点击
Enter interpreter path...，粘贴上面复制的路径 - 选中后，VS Code 底部状态栏会显示解释器路径；可新建
.py文件写import sys; print(sys.executable)验证是否一致
为什么 pip 安装的包在 VS Code 里 import 不到
根本原因通常是解释器没对齐：终端用的是虚拟环境里的 python，而 VS Code 默认用了系统 Python。尤其在使用 venv 或 conda 时，必须让 VS Code 显式指向该环境下的 python 可执行文件。
-
venv环境下，解释器路径通常是venv/bin/python（macOS/Linux）或venv\Scripts\python.exe（Windows） -
conda环境需先激活：conda activate myenv，再运行which python获取路径；不要选base环境除非你真要全局开发 - 检查
pip list和 VS Code 终端中pip list输出是否一致；不一致就说明解释器不同 - 避免在 VS Code 内置终端里手动
source venv/bin/activate—— 这只影响当前终端会话，不影响调试器或语言服务器
调试时提示 “ModuleNotFoundError” 但终端能正常运行
VS Code 调试器（launch.json）默认不读取 shell 的 PATH 或激活脚本，它严格按 "python" 字段指定的解释器路径启动进程。即使你在终端里 source venv/bin/activate 后能跑通，调试仍会失败。
立即学习“Python免费学习笔记（深入）”；
- 确保
.vscode/launch.json中的"python"字段与当前选中的解释器完全一致（推荐留空，让 VS Code 自动继承） - 不要在
launch.json里硬编码"env": {"PATH": "..."}—— 容易出错且不可移植 - 如果项目依赖
src/目录结构，需在launch.json中加"cwd": "${workspaceFolder}/src"或配置"python.defaultInterpreterPath"到工作区设置 - 调试前务必关闭所有 Python 进程（包括后台的 Pylance、Jedi），再重启 VS Code 窗口，避免缓存干扰
最常被忽略的一点：Python 扩展的“语言服务器”（如 Pylance）和调试器用的是同一套解释器配置，但它们各自缓存导入路径。改了解释器后，不重启窗口或不重载窗口（Ctrl+Shift+P → Developer: Reload Window），旧的 import 错误提示可能持续存在。
