Python 3.11.2与Windows 11 22H2下Kivy安装失败求助

问题场景 #

全新安装的Windows 11（OS版本22621.1265），已满足Kivy所有依赖项，但安装时触发编译错误，核心报错如下：

Updated build\lib.win-amd64-cpython-311\kivy\include\config.h
Updated C:\Users\nadee\AppData\Local\Temp\pip-install-878mjsbv\kivy_43cb622015164809b06a8b1af4948f34\kivy\include\config.h
Updated build\lib.win-amd64-cpython-311\kivy\include\config.pxi
Updated C:\Users\nadee\AppData\Local\Temp\pip-install-878mjsbv\kivy_43cb622015164809b06a8b1af4948f34\kivy\include\config.pxi
Updated build\lib.win-amd64-cpython-311\kivy\setupconfig.py
Updated C:\Users\nadee\AppData\Local\Temp\pip-install-878mjsbv\kivy_43cb622015164809b06a8b1af4948f34\kivy\setupconfig.py
Detected compiler is msvc
error: command 'C:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\VC\\Tools\\MSVC\\14.34.31933\\bin\\HostX86\\x64\\link.exe' failed with exit code 1104
[end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for kivy
Failed to build kivy
ERROR: Could not build wheels for kivy, which is required to install pyproject.toml-based projects

解决办法 #

• 补全VS Build Tools组件
  打开Visual Studio Installer，确认使用C++的桌面开发工作负载已安装，且勾选以下组件：MSVC v143 - VS 2022 C++ x64/x86生成工具、Windows 11 SDK（版本10.0.22621.0）、C++ CMake工具。安装完成后重启电脑再尝试安装。

• 直接安装预编译wheel包
  跳过本地编译环节，用pip拉取预编译好的二进制包：
  pip install kivy --only-binary :all:
  该命令会自动匹配你的Python版本和系统架构，避开编译错误。

• 用VS命令提示符执行安装
  找到并打开Visual Studio的x64本机工具命令提示符，在该窗口内运行pip install kivy，确保编译器的环境变量被正确加载，避免因环境变量缺失导致link.exe调用失败。

• 清理缓存后重试
  先清理pip缓存：
  pip cache purge
  手动删除临时安装目录（比如报错里的C:\Users\nadee\AppData\Local\Temp\pip-install-878mjsbv\kivy_43cb622015164809b06a8b1af4948f34），再重新执行安装命令。

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