Skip to content

ModuleNotFoundError：模块未找到

错误信息

                No module named 'x'

快速摘要

你 `import xxx`，但 Python 在所有搜索路径里都找不到 `xxx` 这个模块——可能没装、装错环境了，或路径不对。

为什么发生

  • 第三方包没有安装，或装在了别的虚拟环境里

  • 自定义模块文件不在 Python 的搜索路径中

  • 模块名拼写错误

  • 用了相对导入但运行方式不对（如 python -m vs 直接运行）

最小示例

✗ 错误代码
import requests
# ModuleNotFoundError: No module named 'requests'
✓ 修复代码
# 先在终端运行：pip install requests
import requests

requests 没装。先在终端 pip install requests，再运行代码即可。

如何诊断

  • 阅读错误信息中的模块名

  • 用 pip list 确认包是否安装在当前环境

  • 用 python -c "import sys; print(sys.path)" 查看搜索路径

如何修复

  • 用 pip install <包名> 安装缺失的包

  • 确认在正确的虚拟环境里运行（which python / python -m venv）

  • 把自定义模块放到搜索路径中，或用 sys.path.append 临时添加

如何预防

  • 项目用 requirements.txt 或 pyproject.toml 锁定依赖

  • 每个项目用独立的虚拟环境，避免装错地方

相关资源

相关术语

相关课程

相关练习

← 返回语言