VS Code中ModuleNotFoundError主因是解释器、终端、调试器三者环境不一致；需逐字符比对右下角路径与终端python -c "import sys; print(sys.executable)"输出，确保完全一致，并统一使用python -m pip install安装包。
VS Code 里 import 报 ModuleNotFoundError，90% 不是库没装，而是解释器、终端、调试器三者指向了不同环境。
为什么终端能跑 python --version，但 VS Code 就找不到库？
VS Code 启动时不读取你的 ~/.zshrc、~/.bashrc 或 Windows 的 PowerShell 配置，也不继承你手动 conda activate myenv 过的环境。它只靠 Python 扩展扫描路径或你手动指定的 python.defaultInterpreterPath 来定位解释器。
常见表现：
- 右下角状态栏显示
Python 3.11.5，但终端里运行python -c "import sys; print(sys.executable)"输出却是/usr/bin/python3 -
pip install requests成功，但 import 仍报错；而python -m pip install requests才真正装进当前解释器 - 用
conda env list能看到环境，但Python: Select Interpreter列表里没有——因为 VS Code 没加载 conda 初始化脚本
如何确认并统一解释器、终端、调试器三者路径？
必须逐字符比对，不能只看版本号。
立即学习“Python免费学习笔记（深入）”；
- 在 VS Code 右下角点击 Python 版本 → 确认显示的是完整路径（如
./venv/bin/python或C:myproj.venvScriptspython.exe） - 打开集成终端（
Ctrl+Shift+`），执行：python -c "import sys; print(sys.executable)"，输出必须和右下角路径完全一致 - 检查设置中是否启用了
python.terminal.activateEnvironment（默认为 true；若关闭，终端不会自动切环境） - 调试时，
launch.json中的python字段若未显式指定，会 fallback 到当前选中的解释器；但建议写死："python": "./venv/bin/python"（Linux/macOS）或"python": ".\venv\Scripts\python.exe"（Windows）
装库时最容易踩的坑：pip 和 python 不是一对
裸敲 pip install 调用的是系统或 base 环境的 pip，和当前解释器无关。唯一可靠方式是绑定到解释器本身。
- 在已确认解释器正确的 VS Code 终端中，只用：
python -m pip install requests - 批量安装：
python -m pip install -r requirements.txt - 验证是否装进对的地方：
python -m pip list | grep requests（macOS/Linux）或python -m pip list | findstr requests（Windows） - 如果
python -m pip报错“no module named pip”，说明该环境没 pip（常见于新 conda 环境），先运行：conda activate myenv && conda install pip
本地模块（如 from mypackage import foo）找不到怎么办？
VS Code 默认不把项目根目录加进 sys.path，而 PyCharm 会自动加。这不是解释器问题，是路径感知问题。
- 最稳妥做法：在项目根目录下创建
.vscode/settings.json，添加："python.defaultInterpreterPath": "./venv/bin/python"（确保解释器正确） - 同时，在代码开头临时加路径（仅用于开发验证）：
import sys; sys.path.append(".")，但别提交到生产代码 - 更规范的做法是把项目设为可安装包：在根目录放
pyproject.toml，内容含[build-system]和[project]，然后用pip install -e .安装为 editable 包
真正容易被忽略的是：VS Code 的 Python 扩展不会缓存 sys.path 变更，每次重启终端或调试都会重置。所以硬编码 sys.path.append() 只治标；长期方案必须统一解释器 + 统一 pip + 显式管理项目结构。
