首次在Python中使用外部库python-docx模块遇到异常问题求助

• pip升级不完全导致的包安装路径匹配异常：升级pip过程中出现报错，即便版本号发生变更，也可能存在pip全局路径、当前Python解释器路径不匹配的问题，后续安装的python-docx可能实际被写入其他Python环境的目录，而非当前PyCharm项目关联的解释器对应的site-packages目录。
• 被标记为排除的site-packages目录的影响：PyCharm中红色标识的排除目录不会被纳入项目索引路径，即便该目录下确实存在python-docx模块，PyCharm也无法识别、无法支持导入调用，同时不会为该目录下的库提供代码补全、语法检查等功能。

步骤1：校验当前环境的包安装状态 #

首先在PyCharm当前项目的终端执行以下命令，确认pip对应的Python环境：
pip --version
返回结果的路径末尾会标注关联的Python版本与site-packages路径，确认该路径是否和你看到的红色site-packages目录路径一致。
之后执行命令确认python-docx是否安装在当前环境：
pip show python-docx
如果返回WARNING: Package(s) not found: python-docx，说明之前的安装操作实际写入了其他环境，直接在当前终端执行pip install python-docx即可。

步骤2：解除site-packages目录的排除状态 #

如果上一步确认python-docx已经安装在当前红色标记的site-packages目录下，按以下操作解除排除：

1. 打开PyCharm的File > Settings > Project: 你的项目名称 > Python Interpreter
2. 点击右上角齿轮图标，选择Show All，选中当前项目关联的解释器
3. 点击解释器列表右侧的「Show paths for the selected interpreter」按钮（文件夹样式图标）
4. 在弹出的路径列表中，找到被标记为红色的site-packages路径，选中后点击右侧的+号重新添加，或选中后点击减号删除再重新导入对应路径
5. 保存设置后等待PyCharm完成项目重新索引即可。

步骤3：路径匹配异常兜底方案 #

如果上述操作后仍无法正常导入，直接进入PyCharm的解释器设置界面，点击+号搜索python-docx，通过PyCharm内置的库安装功能直接安装，可自动规避环境路径匹配问题。

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