Python3.9.2安装kivy报错：无法安装基于pyproject.toml的项目

前置操作（优先尝试） #

先升级Python包构建相关的基础工具，大部分该类报错都是工具版本过低不支持pyproject.toml构建规范导致：

pip install --upgrade pip setuptools wheel

升级完成后重新尝试安装kivy即可。 #

若前置操作无效，按以下方案排查处理 #

• 方案1：安装适配Python 3.9的指定kivy版本，避免版本不兼容 #

  直接安装经过兼容性验证的2.1.0版本即可，国内用户可添加镜像源加速：

  pip install kivy==2.1.0 -i https://pypi.tuna.tsinghua.edu.cn/simple
  

  若需要完整功能组件，可安装全量包：

  pip install "kivy[full]==2.1.0" -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 方案2：提前安装系统级编译依赖 #

  若安装时触发本地编译流程报错，按你使用的操作系统提前安装对应依赖：
  • Windows系统：安装Microsoft Visual C++ 14.0及以上版本生成工具，安装时勾选「使用C++的桌面开发」组件即可
  • macOS系统：执行命令安装命令行开发工具：xcode-select --install
  • Linux Debian/Ubuntu系列系统：执行命令安装编译依赖：

    sudo apt-get install python3-dev libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev libportmidi-dev libswscale-dev libavformat-dev libavcodec-dev zlib1g-dev
    

• 方案3：使用干净虚拟环境安装 #

  避免本地环境依赖冲突导致安装失败：

  # 新建虚拟环境
  python -m venv kivy_env
  # Windows系统激活虚拟环境
  kivy_env\Scripts\activate
  # macOS/Linux系统激活虚拟环境
  source kivy_env/bin/activate
  # 升级基础工具后安装kivy
  pip install --upgrade pip setuptools wheel
  pip install kivy
  

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