使用pip安装Python包时如何解决‘ImportError: No module named 'mymodule'’错误？

• 检查pip与Python解释器的路径匹配

  • 执行 which python（Linux/macOS）或 where python（Windows），获取当前运行的Python路径
  • 执行 which pip（Linux/macOS）或 where pip（Windows），查看pip对应的Python环境路径
  • 若两者路径不匹配，说明pip把包装到了别的Python环境里，解决办法：
    • 用 python -m pip install mymodule 替代直接 pip install，确保包安装到当前使用的Python环境
    • 或者明确指定对应版本的pip，比如 pip3 install mymodule（针对Python3环境）

• 手动核查site-packages目录

  • 执行 python -c "import site; print(site.getsitepackages())"，获取Python的包安装目录
  • 打开该目录，确认是否存在mymodule文件夹或对应的.egg-info文件
  • 若不存在，用 pip install mymodule -v 重新安装（-v是verbose模式，会输出详细安装日志，能帮你定位隐藏错误）

• 确认虚拟环境状态

  • 如果你在用虚拟环境，先检查当前终端是否激活了目标虚拟环境
  • 未激活时，pip会把包安装到系统Python环境，而代码如果在虚拟环境中运行，自然找不到包

• 验证导入名称的正确性

  • 部分包的导入名称和pip安装的包名不一致（比如安装python-dateutil后要导入dateutil），去PyPI或包的官方文档确认mymodule的正确导入语句
  • 可以尝试在Python交互环境中输入import mymodule，如果报错，再试试类似import my_package的变体（如果包的结构特殊）

• 清理Python缓存

  • 删除项目目录下的__pycache__文件夹
  • 用 python -B 启动解释器（禁止生成.pyc缓存文件），再尝试导入模块

内容的提问来源于stack exchange，提问作者IlyXXXa_Ubivator