根本原因是Python解释器在sys.path中未找到目标模块路径；需打印sys.path确认搜索顺序，核对which python与which pip路径是否一致，并检查文件名是否与第三方库重名。
根本原因只有一个：Python 解释器在 sys.path 列表里没找到你要导入的模块路径。不是“没装”，而是“找不到”——装在哪、运行用的是哪个环境、代码从哪启动，三者不一致就必然报这个错。
怎么确认当前解释器到底在搜哪些路径？
直接运行这行代码，立刻看到真实搜索顺序：
import sys
for p in sys.path:
print(p)
重点看前三项：
• 第一个空字符串 '' 表示你执行 python script.py 时所在的**当前工作目录**
• 后面跟着标准库路径、site-packages（第三方包安装位置）
• 如果你要 import 的模块不在这些路径里，哪怕它物理存在，也会报错
为什么 pip install 成功了，还是 ModuleNotFoundError？
因为 pip 和 python 很可能不是同一个环境的：
立即学习“Python免费学习笔记（深入）”；
- 终端敲
pip install requests→ 装到了系统 Python 或某个虚拟环境的site-packages - 但 VSCode/PyCharm 点运行时，实际调用的是另一个 Python 解释器（比如项目根目录下的
.venv） - 那个解释器的
sys.path里压根没有你刚装的requests
验证方法：
• 在 IDE 内置终端里执行 which python 和 which pip（macOS/Linux）或 where python 和 where pip（Windows）
• 如果两个路径不一致，就是环境错位
本地模块（比如自己写的 config.py）为啥总找不到？
常见于项目结构稍复杂时，比如：
myproject/
├── main.py
└── src/
└── config.py
这时如果在 main.py 里写 import config，Python 只会在当前目录（myproject/）找，不会自动进 src/ 里翻。
解决方式有且仅有两种靠谱做法：
- 把
src/加进sys.path：sys.path.append('./src')（仅调试用，别放生产） - 用绝对导入 + 正确项目结构：把
src/改成包（加__init__.py），并在main.py中写from src import config，同时确保myproject/是 Python 的工作目录（即cd myproject && python main.py）
千万别建一个叫 numpy.py 或 requests.py 的文件——它会遮蔽同名第三方包，且错误极难排查。
最稳的安装命令是什么？
放弃无脑 pip install。统一用 Python 解释器自带的 pip 模块来装：
# Windows python -m pip install requests <h1>macOS / Linux</h1><p>python3 -m pip install requests
这样能 100% 保证：装到的路径，就是你 python 命令实际使用的那个环境的 site-packages。比记一堆 pip3 pipenv conda install 更直接、更少歧义。
真正麻烦的从来不是“装不上”，而是“装对地方”。每次报 ModuleNotFoundError，先打印 sys.path，再查 which python，最后看文件名有没有和库重名——这三步走完，95% 的问题当场消失。
