Python如何导入docx模块的Document？安装python-docx后报ImportError排查

核心原因 #

• Python解释器环境不匹配：这是该报错的最常见诱因。你执行安装命令用的pip关联的Python解释器，和你运行代码时调用的Python解释器不属于同一个环境。可能的场景包括：pip绑定的是Python2.7，运行代码时用的是Python3；或者安装包时在全局环境，运行代码时在venv、conda等虚拟环境中，不同环境的包互相不通用。
  你可以分别执行pip --version和python --version（如果运行代码用的是python3则执行python3 --version），查看输出的Python版本、绑定路径是否一致，即可验证该问题。
• 操作环境错位：你使用的是Mac设备，但操作的路径是C:\Python27\Scripts，该路径是Windows系统下Python2.7的专属路径，Mac系统本身不存在C盘盘符。如果你是在Mac上运行Windows虚拟机、Wine兼容层时安装的包，在Mac本地原生Python环境运行代码时自然找不到对应安装包。
• 额外注意：你当前写的导入语句from docx import Documents存在语法错误，正确写法是from docx import Document，类名是单数形式。不过该错误的提示会是cannot import name 'Documents' from 'docx'，和你当前的报错无关，解决环境问题后记得修正导入语句即可。

修复方法 #

直接使用你运行代码的Python解释器调用pip执行安装，可完全避免环境错位问题，命令如下：

# 如果你运行代码用的是python命令
python -m pip install python-docx

# 如果你运行代码用的是python3命令
python3 -m pip install python-docx

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