PyCharm中已用pip安装openpyxl仍报ModuleNotFoundError求助

问题描述 #

已通过pip安装openpyxl模块，Windows终端与PyCharm终端均显示安装完成，模块在PyCharm中显示为橙色（非未安装的灰色），但运行代码时仍出现ModuleNotFoundError，确认无拼写/大小写错误。

终端安装记录：

PS C:\Users\GARETH TIROP\PycharmProjects\pythonProjectone> pip3 install openpyxl
Collecting openpyxl
Using cached openpyxl-3.0.10-py2.py3-none-any.whl (242 kB)
Requirement already satisfied: et-xmlfile in c:\users\gareth tirop\appdata\local\programs\python\python310\lib\site-packages (from openpyxl) (1.1.0)
Installing collected packages: openpyxl
Successfully installed openpyxl-3.0.10
PS C:\Users\GARETH TIROP\PycharmProjects\pythonProjectone>

核心原因 #

PyCharm当前使用的Python解释器，与执行pip3 install的解释器并非同一个，导致IDE无法找到已安装的模块。

解决步骤 #

• 步骤1：核对pip与PyCharm的解释器路径

  1. 在终端执行pip3 --version，查看输出的pip所属Python路径，示例输出：

     pip 22.2.2 from C:\Users\GARETH TIROP\AppData\Local\Programs\Python\Python310\lib\site-packages\pip (python 3.10)
     

  2. 打开PyCharm的设置：File > Settings（快捷键Ctrl+Alt+S），进入Project: pythonProjectone > Python Interpreter，查看当前选中的解释器路径。

• 步骤2：切换PyCharm解释器至pip对应的版本

  1. 在Python Interpreter设置界面，点击右上角齿轮图标 → Add
  2. 选择System Interpreter，找到步骤1中pip对应的Python.exe路径（如C:\Users\GARETH TIROP\AppData\Local\Programs\Python\Python310\python.exe）
  3. 点击OK保存设置，重启PyCharm后重新运行代码。

• 步骤3：虚拟环境特殊处理（若使用）
  如果项目启用了虚拟环境，全局安装的openpyxl不会被虚拟环境识别：

  1. 在PyCharm终端激活虚拟环境（若未自动激活）
  2. 执行pip install openpyxl重新安装模块；或直接在PyCharm的Python Interpreter界面点击+，搜索openpyxl并安装到当前虚拟环境解释器中。

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