Python 3.6.5遇ModuleNotFoundError：已安装模块无法导入求助

阿华AIGC实验室

2026-5-29

解决Python模块导入ModuleNotFoundError的方案

针对你遇到的问题——明明通过pip安装了模块且能在site-packages找到，但导入时提示找不到，我整理了几个针对性的排查和解决步骤：

确认pip与Python解释器的对应关系
有时候即使只装了一个Python版本，也可能出现pip和当前使用的Python不匹配的情况。打开命令提示符（CMD）或PowerShell，执行以下命令：
```
where python
```
查看输出的Python路径是否是你安装的3.6.5版本的路径（比如C:\Python36\python.exe）。接着执行：
```
pip --version
```
对比输出中的Python版本和路径，如果和上面的不一致，说明你用的pip不属于这个Python解释器。此时需要用python -m pip install <模块名>重新安装模块，确保模块被安装到正确的site-packages目录下。
检查sys.path是否包含site-packages路径
Python会从sys.path列表里的路径查找模块，你可以在Python交互环境中执行以下代码确认：
```
import sys
print(sys.path)
```
查看输出里是否包含你的Python3.6.5对应的site-packages路径（比如C:\Python36\Lib\site-packages）。如果没有，有两种解决方式：
1. 临时方案：在代码开头手动添加路径：
```
import sys
sys.path.append("C:\\Python36\\Lib\\site-packages")
```
2. 永久方案：将该路径添加到系统环境变量的PYTHONPATH中，之后重启Python环境即可生效。
确认模块导入名称是否正确
有些模块的安装名称和导入名称不一致，比如python-dateutil安装后导入用dateutil。你需要确认：
- Discord API的正确导入名称是discord（不是Discord或其他变体）
- cx_Freeze的正确导入名称是cx_Freeze
  如果不确定，可以查看site-packages里的模块文件夹名称，或者参考模块的官方文档确认导入方式。
强制重新安装模块
可能模块的安装文件存在损坏，尝试用以下命令强制重新安装：
```
python -m pip install --upgrade --force-reinstall discord cx_Freeze
```
这会覆盖现有安装文件，修复可能的损坏问题。
排查虚拟环境干扰
即使你只装了一个Python版本，也可能不小心激活了某个虚拟环境，导致全局安装的模块无法被当前环境识别。执行以下命令检查：
- CMD中：echo %VIRTUAL_ENV%
- PowerShell中：$env:VIRTUAL_ENV
  如果有输出，说明处于虚拟环境中，你可以执行deactivate退出虚拟环境，或者在虚拟环境中重新安装需要的模块。