PyCharm中openpyxl模块已安装但无法加载的问题求助

1. 确认项目解释器与模块安装状态 #

• 打开PyCharm，进入File > Settings > Project: [你的项目名] > Python Interpreter
• 检查列表中是否存在openpyxl，同时确认当前解释器的路径（比如Python 3.x.x后方的路径）
• 若列表中无openpyxl，点击+搜索该模块，选择当前项目解释器完成安装

2. 核对运行配置的解释器 #

• 点击右上角运行按钮旁的下拉菜单，选择Edit Configurations
• 在配置窗口中，确保Python interpreter选项与Settings中选定的解释器一致，不一致则切换后保存

3. 验证解释器与模块路径匹配 #

• 打开PyCharm内置终端，执行以下命令：
  • Windows：where python + pip show openpyxl
  • Mac/Linux：which python + pip show openpyxl
• 对比输出的Python路径与openpyxl安装路径，若不匹配，说明使用了不同环境：
  • 激活项目对应的虚拟环境（Windows：venv\Scripts\activate；Mac/Linux：source venv/bin/activate）
  • 重新执行pip install openpyxl

4. 调整系统PATH环境变量 #

• Windows：右键此电脑 > 属性 > 高级系统设置 > 环境变量，在系统变量-Path中，将项目使用的Python安装路径（如C:\Python39和C:\Python39\Scripts）移至列表最顶端，避免其他版本干扰
• Mac/Linux：编辑~/.bashrc或~/.zshrc文件，添加：

  export PATH="/usr/local/bin/python3:$PATH"
  

  保存后执行source ~/.bashrc或source ~/.zshrc生效

5. 清理缓存并重启 #

• 进入File > Invalidate Caches...，勾选Clear file system cache and local history，点击Invalidate and Restart
• 重启后重新运行代码

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