已安装openpyxl但Python报ModuleNotFoundError如何解决

出现该问题的唯一核心原因是：执行pip install openpyxl时的包安装路径，和你运行代码时使用的Python解释器的site-packages路径不匹配，也就是包装到了别的Python环境里，你当前跑代码的环境根本没装上openpyxl。

• 第一步：定位你运行代码所用的Python解释器的准确路径
  • 如果你是在终端直接跑脚本：在你平时执行脚本的同一个终端窗口里，根据你常用的启动命令执行对应语句：

    # 平时用 python xxx.py 跑脚本执行这个
    python -c "import sys; print(sys.executable)"
    
    # 平时用 python3 xxx.py 跑脚本执行这个
    python3 -c "import sys; print(sys.executable)"
    

    命令输出的完整路径就是你当前用的Python解释器位置，记下来即可。
  • 如果你是用VS Code、PyCharm等IDE跑代码：直接看IDE界面底部状态栏显示的解释器路径，或者在IDE的内置终端里执行上面的命令获取路径。
• 第二步：强制用当前解释器对应的pip安装openpyxl
  不要直接用裸的pip/pip3命令安装，直接用你刚才查到的解释器路径加-m pip参数执行安装，从根源避免装错环境：

  # 替换成你上一步查到的实际解释器路径
  <你的Python解释器完整路径> -m pip install openpyxl
  

  举个例子：如果上一步查到解释器是/usr/bin/python3.10，就执行/usr/bin/python3.10 -m pip install openpyxl；如果是Windows下的C:\Users\xxx\AppData\Local\Programs\Python\Python311\python.exe，就执行对应路径加-m pip install openpyxl。

• 多Python版本混装：比如系统自带Python3.8，你自行安装了Python3.12，默认pip命令绑定的是3.8版本的pip，把包装到3.8的目录下，但你跑代码用的是3.12解释器，就会触发报错。
• 虚拟环境未激活：如果你用venv/conda等虚拟环境，装包时没有激活对应环境，包装到了全局环境里；或者激活了环境装包，但跑代码时没激活环境用了全局解释器，都会找不到包。conda环境建议优先执行conda install openpyxl安装，避免渠道冲突。
• Windows系统路径优先级问题：如果既从微软商店安装过Python，又从Python官网下载过安装包，系统环境变量里的路径优先级混乱，会导致pip和python命令不匹配。

装完后在同一个终端/IDE内置终端执行以下命令，能正常输出版本号即修复成功，再运行自己的代码就不会触发ModuleNotFoundError：

# 用你自己的实际解释器路径替换
python -c "import openpyxl; print(openpyxl.__version__)"

内容的提问来源于stack exchange，提问作者Ibrahim Kashif Shamim