Python离线安装.whl包遇MarkupSafe版本匹配错误求助

• 检查下载的包完整性
  在源机器上执行ls 下载目录 | grep MarkupSafe，确认存在适配Python3.11和Ubuntu20.04的whl文件，文件名格式应为MarkupSafe-2.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl（核心是cp311对应Python3.11，manylinux系列适配Ubuntu20.04）。如果没有这个文件，说明下载时没获取到对应平台的二进制包。

• 重新下载适配平台的包
  在源机器上重新执行下载命令，强制指定平台和Python版本，确保拿到正确的二进制轮子：

  pip download -r requirements.txt --platform manylinux_2_17_x86_64 --python-version 311 --only-binary=:all:
  

  这个命令会跳过源码包，只下载适配指定平台和Python版本的二进制whl，避免因源码编译导致的问题。

• 确认文件复制完整
  将源机器下载的所有文件（包括MarkupSafe的whl）完整复制到目标机器的~/LocalPythonPackage目录，执行ls ~/LocalPythonPackage | grep MarkupSafe确认文件存在且文件名正确。

• 验证安装命令路径
  确保--find-links指定的路径正确，建议使用绝对路径避免解析错误。安装命令可调整为：

  pip install --no-index --find-links=/home/你的用户名/LocalPythonPackage -r requirements.txt
  

  替换成目标机器上的实际绝对路径即可。

• 核对requirements.txt版本
  检查requirements.txt中MarkupSafe==2.1.1的拼写和版本号是否与下载的whl文件完全一致，避免版本号或大小写错误导致匹配失败。

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