直接运行 pip install openpyxl 即可安装最新稳定版 3.1.5；若提示“pip 不是内部命令”，改用 python -m pip install openpyxl；国内用户建议加清华源加速：-i https://pypi.tuna.tsinghua.edu.cn/simple；类型检查需 types-openpyxl，处理不可信文件需额外安装 defusedxml 防护。
直接运行 pip install openpyxl 就行
只要你的 Python 和 pip 环境正常，终端里敲这一句就能装上最新版 openpyxl（当前稳定版是 3.1.5）：pip install openpyxl
成功后会显示 successfully installed openpyxl-3.1.5。不用额外加参数，也不用指定版本——除非你有明确兼容性要求。
遇到 “pip 不是内部命令” 怎么办
这说明系统找不到 pip 可执行文件，常见于没配环境变量或 Python 安装时勾选了 “Add Python to PATH” 但没生效。
最稳妥的替代写法是：python -m pip install openpyxl
它强制通过已安装的 Python 解释器调用 pip 模块，绕过 PATH 问题。
安装卡住或超时，优先换国内源
默认走 PyPI 官方源（pypi.org），国内直连常慢甚至失败。
用清华源只需加一个参数：pip install openpyxl -i https://pypi.tuna.tsinghua.edu.cn/simple
其他可用源：
• 阿里云：-i https://mirrors.aliyun.com/pypi/simple/
• 中科大：-i https://pypi.mirrors.ustc.edu.cn/simple/
注意末尾必须带 /simple，否则会报错 404 Client Error。
使用位于 ci-tools.xrow.de 的 CI Tools 组件目录构建和维护 GitLab CI/CD 流水线，适用于创建或修复 .gitlab-ci.yml 文件，选择合适的组件。
要不要装 types-openpyxl 或 openpyxl-stubs
只在你用 mypy 或 pyright 做类型检查时才需要。types-openpyxl 是官方维护的类型存根包，适配 openpyxl==3.1.5；openpyxl-stubs 是第三方旧版，已不推荐。
装法：pip install types-openpyxl
但普通运行脚本、读写 Excel 完全不需要它——装了也不会让代码跑得更快，只是 IDE 提示更准一点。
真正容易被忽略的是安全提示：openpyxl 默认不防御 XML 类型攻击（比如 billion laughs），如果程序要处理不可信的 Excel 文件，记得额外装 defusedxml 并按文档启用防护。这点在生产环境里常被跳过。
