根本原因是python3与pip3指向不同Python环境；需用which命令确认二者路径一致，优先使用python3 -m pip安装，并验证sys.path是否包含目标site-packages路径。
不是模块没装，而是你运行脚本的 python3 和安装包的 pip3 指向了不同的 Python 环境。
确认当前解释器和 pip 是否匹配
这是所有问题的起点。终端里执行这两条命令，必须指向同一个路径：
-
which python3—— 查看当前python3可执行文件位置 -
which pip3—— 查看当前pip3可执行文件位置
如果输出路径不一致（比如一个是 /usr/bin/python3，另一个是 ~/.pyenv/versions/3.11.9/bin/pip3），那你就已经掉进坑里了。更可靠的做法是用 python3 -m pip 安装：它强制让当前 python3 调用自己的 pip 模块，避免错位。
检查 sys.path 是否包含目标 site-packages
报错时 Python 只在 sys.path 列表里找模块。运行下面这行，看输出里有没有你期望的 site-packages 路径：
python3 -c "import sys; [print(p) for p in sys.path if 'site-packages' in p]"
如果没看到，说明要么包根本没装到这个环境，要么你压根没激活对的虚拟环境。常见漏点：
- 用
conda activate myenv激活后，却在未激活状态下执行pip install - VS Code 左下角显示的 Python 解释器路径，和终端里
which python3不一致 - 某些 Linux 发行版（如 Ubuntu 24.04）默认把
pip3绑定到系统 Python，但用户手动安装的 Python 3.11+ 自带的是pip，不是pip3
区分包名和导入名（比如 scikit-image / skimage）
很多包的安装名和 import 名不一致，装对了也找不到。典型例子：
-
pip install scikit-image→import skimage（不是import scikit_image） -
pip install opencv-python→import cv2（不是import opencv） -
pip install PyMC（不是PyMC3）→import pymc（全小写，且 v4+ 已弃用PyMC3）
查官方文档或 PyPI 页面的 “Usage” 小节，别只看包名。装完后直接在对应解释器里试：
python3 -c "import skimage; print(skimage.__file__)"
IDE 或 Jupyter 内核没选对解释器
VS Code、PyCharm、Jupyter 都可能缓存旧的解释器配置。不要只信终端里的 pip list，要验证“真正跑代码的那个环境”：
- 在 VS Code 中，按
Ctrl+Shift+P→ 输入 “Python: Select Interpreter”，确认路径和which python3一致 - Jupyter notebook 里运行
!which python和import sys; sys.executable，两者必须相同 - PyCharm 的 Project Interpreter 设置里，点开齿轮 → “Show All…” → 确认右侧列表中选中的解释器路径是否真实存在且可执行
最隐蔽的坑是：你在终端里激活了虚拟环境，但 IDE 启动时没读取 shell 配置（比如没 source ~/.zshrc），导致它仍用系统默认解释器。
真正卡住人的从来不是“怎么装”，而是“装给谁”。每次遇到 ModuleNotFoundError，先问自己一句：我敲 pip install 时，背后那个 Python 解释器，和我现在双击运行脚本时启动的那个，是不是同一个？答案不确定，就别急着重装。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
