ModuleNotFoundError: No module named 'openpyxl'主因是pip与python环境不一致，需用python -m pip install openpyxl对齐环境，并检查Python版本（3.7–3.12兼容openpyxl 3.1+）、换清华镜像源解决下载中断，排除伪xlsx文件导致的KeyError。
直接结论：不是 pip 命令写错了，而是你当前运行 python 的环境和你用 pip install openpyxl 安装的环境不一致——90% 的 ModuleNotFoundError: No module named 'openpyxl' 都卡在这一步。
怎么确认 pip 和 python 指向同一个环境
新手常输 pip install openpyxl，但实际运行脚本的是 python3.11 或 python3.12，而 pip 默认可能绑在旧版 Python 上。必须强制对齐：
- 查当前 Python 解释器路径：
python -c "import sys; print(sys.executable)" - 查当前 pip 对应的 Python：
pip -V（看输出末尾的 Python 路径） - 如果不一致，统一用
python -m pip install openpyxl—— 这能确保装进python正在用的那个 site-packages - 用 Anaconda？优先用
conda install openpyxl，避免 pip/conda 混装冲突
安装时提示 TimeoutError 或 SSLError
国内直连 PyPI 经常中断，导致 openpyxl 下载不全（比如缺 reader/excel.py），后续 import 就报错，但 pip 显示“Successfully installed”——这是假成功。
- 换国内镜像源安装：
python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ openpyxl - 如果还失败，加
--trusted-host pypi.tuna.tsinghua.edu.cn - 企业内网用户可先下载 whl 文件手动安装：
python -m pip install openpyxl-3.1.2-py3-none-any.whl
Python 版本太新或太旧
openpyxl 不支持所有 Python 版本。2026 年常见踩坑点是：装了 Python 3.13（预览版），但 openpyxl 最新稳定版（3.1.2）尚未适配；或者还在用 Python 3.5，而 openpyxl 2.6+ 已彻底放弃支持。
- 查 Python 版本：
python --version - 查兼容表：
openpyxl 3.1+→ 仅支持3.7–3.12；openpyxl 3.0.x→ 支持3.6–3.11 - 若用 Python 3.13，暂时降级到 3.12，或等官方发布适配版本（目前无正式支持）
- 若用 Python 3.6，别装 3.1.x，改用
pip install openpyxl==3.0.10
import 时抛 KeyError: '[Content_Types].xml'
这不是安装问题，是文件本身损坏或格式不对。openpyxl 只读标准 .xlsx（ZIP 容器 + XML 结构），遇到以下情况会炸：
- 文件后缀是 .xlsx，但其实是 WPS 保存的“伪 xlsx”（没包含
[Content_Types].xml） - Excel 文件被其他程序（如 LibreOffice、旧版 Excel）另存为时破坏了 ZIP 结构
- 文件是加密的、只读的，或被系统临时锁住（尤其 Windows 下双击打开过）
- 验证方式：
unzip -l your_file.xlsx | grep Content_Types（Linux/macOS）；Windows 可改后缀为 .zip 后解压查看根目录是否存在该文件
真正麻烦的不是装不上，而是你以为装上了、也 import 成功了，结果一读文件就崩在 [Content_Types].xml——这个错误不会告诉你文件有问题，只会甩个 KeyError，容易误判成库故障。
