Python3.9导入已安装的docx等site_packages模块提示无该模块报错

安全阿岳

2026-10-5

解决方案

首先确认你安装的包名正确：docx对应的官方维护安装包是python-docx，直接执行pip install python-docx重装，避免安装到同名的错误废弃包
检查Python解释器匹配度：
在你运行代码的终端分别执行以下命令，确认pip关联的Python版本和你运行代码用的Python版本一致：
```
python --version
pip --version
```
如果你用的是Python3，可替换为python3 --version和pip3 --version核对，版本不一致的话，用对应Python版本的pip安装依赖即可。
检查PyCharm项目解释器配置：
打开PyCharm → 文件 → 设置 → 项目:[你的项目名称] → Python解释器，核对当前选中的解释器路径，是否就是你安装了python-docx的Python路径。如果项目用了独立虚拟环境，需要在虚拟环境激活状态下重新安装依赖，或者切换到你已经装过依赖的全局/其他解释器。
排查本地文件冲突：
检查你的项目根目录下有没有命名为docx.py的自定义文件，如果有直接改名，同时删除同目录下__pycache__文件夹里的对应缓存文件，避免导入时优先匹配本地文件。
核对Python搜索路径：
运行以下代码查看当前Python的模块搜索路径：
```
import sys
print(sys.path)
```
如果输出中没有你存放第三方包的site-packages目录，可在脚本开头临时添加路径：
```
import sys
sys.path.append("你的site-packages目录完整绝对路径")
```
如需永久生效，可在系统环境变量中新增PYTHONPATH变量，值设为site-packages目录的完整路径。