在PyCharm中安装Kivy遇错，执行py -m pip install kivy失败求助

核心原因 #

你遇到的报错是因为Kivy 2.1.0指定的依赖包kivy_deps.sdl2_dev~=0.4.5没有适配Python 3.11的预编译版本，pip无法找到符合要求的包，导致构建依赖失败。dotenv的报错大概率也是相同逻辑：旧版本包不兼容当前Python版本，或依赖版本要求与现有仓库包不匹配。

针对Kivy的解决方案 #

方案1：安装适配Python 3.11的Kivy版本 #

Kivy 2.2.0及以上版本已更新依赖要求，支持Python 3.11，执行命令：

py -m pip install kivy>=2.2.0

方案2：降级Python到3.10 #

如果必须使用Kivy 2.1.0，Python 3.10有对应的kivy_deps.sdl2_dev~=0.4.5预编译包，降级后重新执行安装命令即可。

方案3：手动兼容依赖（不推荐） #

强制安装更高版本的kivy_deps.sdl2_dev，再尝试安装Kivy，可能存在兼容性风险：

py -m pip install kivy_deps.sdl2_dev==0.5.1
py -m pip install kivy

针对dotenv的解决方案 #

1. 先更新pip到最新版，修复版本匹配逻辑：

py -m pip install --upgrade pip setuptools wheel

2. 安装官方维护的python-dotenv包（旧版dotenv已停止维护，易出现版本兼容问题）：

py -m pip install python-dotenv

通用排查步骤 #

• 确认当前Python版本：py --version，避免使用过于前沿的Python版本（如刚发布的大版本），多数第三方包需要时间完成适配
• 使用虚拟环境隔离依赖，避免全局环境冲突：

py -m venv kivy-env
# Windows系统激活虚拟环境
kivy-env\Scripts\activate
# 激活后再执行各类安装命令

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