已安装python-docx但执行import docx仍报ModuleNotFoundError问题求助

可能的原因及解决方案 #

• 解释器与pip绑定不一致
  这是最常见的诱因。你执行pip命令时绑定的Python解释器，和你运行代码时调用的解释器不属于同一个环境。
  先在你运行代码的环境中执行以下代码，获取当前解释器的相关路径：

import sys
# 打印当前解释器的可执行文件路径
print(sys.executable)
# 打印当前解释器的包搜索路径
print(sys.path)

将输出的路径和pip安装时返回的python-docx存放路径对比，如果二者不匹配，直接用当前解释器的绝对路径执行安装命令即可：

<替换为上面输出的sys.executable的路径> -m pip install python-docx

示例：

C:\Users\16dea\AppData\Local\Programs\Python\Python310\python.exe -m pip install python-docx

• 虚拟环境隔离
  如果你运行代码时激活了虚拟环境，虚拟环境会默认屏蔽全局安装的第三方包，全局pip安装的python-docx无法被虚拟环境读取。你需要先激活对应虚拟环境，再在虚拟环境内执行pip install python-docx命令。

• 本地文件命名冲突
  检查你运行代码的同级目录下，是否存在名为docx.py的文件，或者是否有名为docx的文件夹。Python导入模块时会优先读取当前工作目录下的同名文件/文件夹，导致无法加载正确的第三方库。将你本地的同名文件/文件夹重命名，同时删除同级目录下的__pycache__缓存文件夹即可。

• IDE解释器配置错误
  如果使用PyCharm、VSCode等IDE运行代码，确认IDE当前项目选中的Python解释器，和你安装python-docx的解释器为同一个。在IDE的解释器选择面板切换到正确的版本即可。

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