pip安装spacy==2.1.0时报错无匹配分布，版本列表中已存在该包

pip的版本展示规则和环境适配规则存在差异，这是出现“列表内存在目标版本但提示无匹配发行版”现象的根本原因：

• pip报错中列出的所有spacy版本，是PyPI平台上累计存在过的所有spacy版本号，和当前系统环境、Python版本、CPU架构没有关联
• pip判定“无匹配发行版”的实际逻辑是：在所有列出的版本中，没有找到同时兼容当前Python版本、操作系统、CPU架构的可安装包

具体到spacy 2.1.0这个版本：它是2019年发布的版本，原生最高兼容Python3.7，从发布到停更的全周期内没有出过适配Python3.8的预编译wheel包。当前使用Python3.8.3时，pip检索完所有2.1.0的可安装文件后，发现没有匹配cp38（Python3.8专属标识）的安装包，哪怕版本号在展示列表里，也会触发报错。
直接拉取tar.gz源码安装失败（报exited with status 1）也是同一个原因：spacy 2.1.0的源码本身没有适配Python3.8的语法差异，在新Python环境下编译就会直接报错；同时新版的构建工具（如高版本setuptools）已经不再兼容这个老版本包的构建流程，进一步加剧了安装失败的概率。安装其他老版本包（比如早期版本的scikit-learn）遇到同类问题，也是完全一致的逻辑。

• 最稳妥、零折腾的方案：匹配spacy 2.1.0的原生兼容环境
  spacy 2.1.0的官方适配环境是Python3.6/3.7，只需要新建一个Python3.7版本的虚拟环境，直接执行pip install spacy==2.1.0就能正常安装，不会触发版本不匹配的问题。
• 必须保留Python3.8环境的折中方案
  如果因为项目限制没法更换Python版本，可以选择2.1.x系列中已经完成Python3.8适配的最后一个小版本spacy==2.1.9。这个版本在2019年末发布，已经做了Python3.8的语法兼容，不需要折腾源码编译就能直接在3.8环境下安装，和2.1.0的功能差异极小。
• 硬在当前Python3.8环境安装spacy 2.1.0的操作步骤
  如果必须精准卡到2.1.0这个版本号，不能用替代版本，可以按流程操作：
  1. 先在虚拟环境中把构建工具降到老版本兼容的区间，避免新工具的兼容性校验拦截老包：
     pip install "setuptools<58" "wheel<0.37"
  2. 手动安装所有和Python3.8兼容的spacy 2.1.0依赖版本，不要让pip自动拉取最新依赖，避免版本不匹配导致编译失败：
     对应兼容依赖包括cymem==2.0.3、preshed==2.0.1、murmurhash==0.28.0、thinc==7.0.8、numpy==1.21.6、blis==0.2.4
  3. 跳过构建隔离机制，手动安装spacy 2.1.0源码包：
     pip install --no-build-isolation spacy==2.1.0
     注意：这个硬安装方案的成功率受系统环境影响较大，因为spacy2.1.0的源码本身和Python3.8存在语法兼容性差异，部分场景下打补丁也无法完全适配，优先建议使用前面的两个低折腾方案

如果按上面的步骤操作还是报错，可以核对两个信息：

• 当前使用的Mac是Intel架构还是Apple Silicon架构：spacy 2.1.0发布时Apple Silicon还未上市，就算适配了Python3.7，也没有M系列芯片的原生预编译包，需要额外安装Rosetta2转译层才能运行
• 安装时的完整编译报错日志：如果是源码编译阶段失败，日志里会明确标出是哪一行语法不兼容Python3.8，针对性调整代码补丁就能解决。

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