pip 显示 Requirement already satisfied，运行脚本却出现 ModuleNotFoundError，先核对安装和运行是否使用同一个 Python。本文面向 Windows + VS Code 用户，给出最短诊断路径，并用两个隔离环境验证“装在 A，运行在 B”的问题。代码实验已执行，界面图来自官方文档。
文章目录
- 1. 先认清报错，别重复安装
- 2. 在报错发生的地方核对环境
- 3. VS Code 要选对解释器，旧终端也要复查
- 4. 可复现：装进 A，却用 B 导入
- 5. 环境一致仍报错，查这四项
1. 先认清报错，别重复安装
这两条信息并不矛盾：pip 检查的是它所属环境，脚本导入的是运行解释器的环境。
Requirement already satisfied: PyYAML ... ModuleNotFoundError: No module named 'yaml'这里的 PyYAML 是安装名，yaml 是导入名。不要机械地把报错中的每个模块名都交给 pip；先核查库的正式安装说明。还要区分“模块不存在”和“模块找到了、但里面没有某个属性或符号”。后者不一定靠安装解决。
2. 在报错发生的地方核对环境
在 VS Code 实际运行的脚本中临时加入：
importsysimportimportlib.utilprint("解释器:",sys.executable)print("环境前缀:",sys.prefix)print("yaml 模块:",importlib.util.find_spec("yaml"))None表示当前导入搜索未找到 yaml。这个检查适用于本例的顶层模块；检查带点的模块名可能先导入父包，不要把它当成无副作用的通用扫描工具。
再到终端检查 pip。下面假设正在使用项目里的.venv：
.\.venv\Scripts\python.exe-m pip--version.\.venv\Scripts\python.exe-m pip show PyYAML将 pip 输出的目录和脚本里的解释器路径对照。路径不一致时，优先解决环境选择；环境一致但包不存在时，再安装。PowerShell 中执行带空格的绝对解释器路径，可使用& "完整路径\python.exe" -m pip ...。
python -m pip把 pip 绑定到指定 Python；裸写pip仍可能命中别的环境。pip 官方说明
3. VS Code 要选对解释器，旧终端也要复查
按 Ctrl+Shift+P，执行 Python: Select Interpreter。先看顶部当前解释器，再选择目标环境；图中 Global、Conda 和 Workspace 来自不同环境来源，版本号相近不代表路径相同。
选好后重新运行诊断脚本。旧终端可能仍保留原来的环境，建议新开终端并再次检查解释器和 pip。调试配置若显式指定了其他 Python，也要核对。以实际输出为准，而不是仅凭状态栏判断。
图源：Microsoft / VS Code 官方文档，© Microsoft Corporation，文档按 CC BY 3.0 US 提供，见 仓库许可。原图未修改，框线来自原图。
4. 可复现：装进 A，却用 B 导入
在新的教学目录中运行，不修改已有项目环境。前提是 Windows 已安装 Python，py可用，安装依赖需要能访问可信包源。
py-m venv env-a py-m venv env-b.\env-a\Scripts\python.exe-m pip install PyYAML==6.0.3.\env-a\Scripts\python.exe-c"import yaml; print(yaml.__version__)".\env-b\Scripts\python.exe-c"import yaml"本次 Windows / Python 3.12.10 实际结果：A 导入成功并显示 6.0.3；B 返回No module named 'yaml'。两者完全可以同时成立。
把依赖装进真正运行脚本的 B，再验证来源：
.\env-b\Scripts\python.exe-m pip install PyYAML==6.0.3.\env-b\Scripts\python.exe-c"import sys,yaml; print(sys.executable); print(yaml.__version__); print(yaml.__file__)"本次 B 修复后导入成功，模块路径位于 B 的 site-packages。6.0.3 是本次复现版本，并非“所有项目必须升级到这个版本”的建议。虚拟环境隔离行为见 Python 官方教程。
5. 环境一致仍报错，查这四项
| 检查项 | 该看什么 | 下一步 |
|---|---|---|
| 安装失败 | 安装命令退出状态、完整错误 | 解决网络或依赖构建问题后再导入 |
| 名称不一致 | 正式安装名与导入名 | 按库文档修正，不猜包名 |
| 同名文件遮蔽 | 项目里的 yaml.py 等文件 | 改名并重启运行进程，核对模块来源 |
| 不同运行入口 | 终端、调试器、Notebook 内核 | 在出错入口打印 sys.executable |
不要用关闭证书校验、全局改路径或无限升级所有依赖作为第一步。修复完成的标准是：同一解释器安装、导入成功、模块来源正确、原脚本通过相关功能验证。
