导入python-docx时遭遇ModuleNotFoundError问题求助

问题场景 #

1. 初始导入时报错：

Traceback (most recent call last):
File "C:\Users\kinga\PycharmProjects\InvoiceGenerator\main.py", line 8, in
import docx
ModuleNotFoundError: No module named 'docx'

执行pip install python-docx后问题未解决，改用from docx import Document时出现新错误：

Traceback (most recent call last):
File "C:\Users\kinga\PycharmProjects\InvoiceGenerator\main.py", line 8, in
from docx import Document
File "C:\Users\kinga\PycharmProjects\InvoiceGenerator.venv\Lib\site-packages\docx.py", line 30, in
from exceptions import PendingDeprecationWarning
ModuleNotFoundError: No module named 'exceptions'

问题根源 #

• 第一个错误要么是未安装python-docx模块，要么是PyCharm使用的虚拟环境与执行pip命令的环境不一致。
• 第二个错误是核心：误安装了旧版的docx包（该包不兼容Python3），而非官方的python-docx。Python3已移除exceptions模块，旧包仍在调用该模块导致报错。

解决步骤 #

1. 卸载错装的docx包 #

打开命令提示符或PyCharm终端，执行：

pip uninstall docx

2. 安装官方python-docx模块 #

执行正确的安装命令：

pip install python-docx

3. 确认PyCharm虚拟环境已安装该模块 #

• 打开PyCharm，进入File > Settings > Project: InvoiceGenerator > Python Interpreter
• 查看已安装包列表，若没有python-docx，点击右上角+按钮，搜索python-docx后点击Install Package完成安装

4. 验证代码 #

使用正确的导入语句：

from docx import Document

运行代码即可确认错误消除。

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