pandas从0.25.3升级至1.3.2失败，执行pip升级命令多次报错如何解决？

核心原因梳理 #

你遇到的报错主要来自两类问题：

1. 版本兼容限制：pandas 1.3.2仅支持3.7、3.8、3.9三个版本的Python，若你的Python版本低于3.7，pip会自动过滤所有1.x版本的pandas安装包，最高仅能安装0.25.3版本，也就是你当前的版本。
2. 命令语法错误：
   • 执行pip install --upgrade pandas 1.3.1时，pip会将pandas和1.3.1识别为两个独立的安装包，自然找不到名为1.3.1的包
   • 执行pip install --upgrade pandas==1.3.1报错，大概率是输入时在==后多加了空格，导致pip无法识别正确的版本号

操作步骤 #

第一步：验证Python版本 #

执行命令查看当前生效的Python版本：
python --version
或
python3 --version

第二步：分场景处理 #

场景1：Python版本低于3.7

这是最常见的原因，按以下步骤操作：

• 先备份现有环境的依赖包，避免后续出现兼容问题：
  pip freeze > requirements.txt
• 下载安装3.7~3.9范围内的Python稳定版本，安装时务必勾选「Add Python to PATH」选项
• 重启终端，重新执行python --version确认新版本生效后，执行安装命令：
  pip install pandas==1.3.2

场景2：Python版本为3.7/3.8/3.9

属于pip本身或源的问题，按以下步骤操作：

• 先升级pip到最新版本：
  python -m pip install --upgrade pip
• 卸载现有旧版本pandas：
  pip uninstall pandas -y
• 用国内镜像源安装指定版本pandas：
  pip install pandas==1.3.2 -i https://pypi.tuna.tsinghua.edu.cn/simple

验证安装结果 #

安装完成后执行以下命令确认版本正确：
python -c "import pandas; print(pandas.__version__)"
输出为1.3.2即为安装成功。

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