无法安装Kivy：pip安装时kivy_deps.sdl2_dev版本匹配失败报错

问题描述 #

执行pip install kivy后出现如下报错：

Collecting kivy
Using cached Kivy-2.1.0.tar.gz (23.8 MB)
Installing build dependencies ... error
error: subprocess-exited-with-error

× 用于安装构建依赖的pip子进程未成功运行。
│ 退出码：1
╰─> [10行输出]
Collecting setuptools
Using cached setuptools-65.5.1-py3-none-any.whl (1.2 MB)
Collecting wheel
Using cached wheel-0.38.4-py3-none-any.whl (36 kB)
Collecting cython!=0.27,!=0.27.2,<=0.29.28,>=0.24
Using cached Cython-0.29.28-py2.py3-none-any.whl (983 kB)
Collecting kivy_deps.gstreamer_dev~=0.3.3
Using cached kivy_deps.gstreamer_dev-0.3.3-cp311-cp311-win_amd64.whl (3.9 MB)
ERROR: Could not find a version that satisfies the requirement kivy_deps.sdl2_dev~=0.4.5 (from versions: 0.5.1)
ERROR: No matching distribution found for kivy_deps.sdl2_dev~=0.4.5
[end of output]

note: 该错误源自子进程，大概率不是pip的问题。
error: subprocess-exited-with-error

× 用于安装构建依赖的pip子进程未成功运行。
│ 退出码：1
╰─> 详见上述输出。

note: 该错误源自子进程，大概率不是pip的问题。

核心问题是Kivy 2.1.0要求的kivy_deps.sdl2_dev~=0.4.5版本不存在，当前仅能找到0.5.1版本，导致依赖安装失败。

解决方案 #

• 安装适配高版本依赖的Kivy版本：直接安装Kivy 2.2.0及以上版本，这些版本已更新依赖要求，兼容kivy_deps.sdl2_dev==0.5.1，执行命令：

  pip install kivy>=2.2.0
  

• 手动指定兼容的依赖版本后安装Kivy：先安装可用的kivy_deps.sdl2_dev版本，再安装Kivy，命令如下：

  pip install kivy_deps.sdl2_dev==0.5.1
  pip install kivy
  

• 调整Python版本：报错显示使用的是Python 3.11，Kivy 2.1.0对Python 3.11的支持不完善，降级到Python 3.10后再执行pip install kivy即可正常安装。

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