You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

Python 3.14环境下Pygame安装失败的问题排查与解决方案咨询

Python 3.14环境下Pygame安装失败的解决方案

嘿,我看了你的错误日志,核心问题出在编译依赖缺失上——因为Python 3.14是比较新的版本,Pygame暂时还没有适配它的预编译安装包,所以pip会自动尝试从源码编译,但你的环境缺少必要的编译组件。下面是一步步的解决办法:

1. 修复Distutils模块缺失

Python 3.12及之后的版本已经移除了内置的distutils模块,而Pygame编译需要用到它。你可以通过更新setuptools来补上这个依赖:

pip install --upgrade setuptools
pip install setuptools[distutils]

2. 安装Windows C++编译工具链

源码编译Pygame必须要有Microsoft的C++编译工具,你需要做这些:

  • 打开Microsoft Visual Studio Installer(如果没安装,先去官网下载)
  • 在“工作负载”里勾选「桌面开发使用C++」,确保选中了MSVC v143 构建工具和对应你系统版本的Windows SDK(比如Windows 10/11 SDK)
  • 安装完成后重启你的终端,让环境变量生效

3. 可选:直接用预编译Wheel包安装(更省心)

如果不想折腾编译环境,你可以找适配Python 3.14的Pygame预编译wheel文件:

  • 找到对应你系统架构(x64)和Python 3.14的.whl文件
  • 下载后,用pip本地安装:
pip install 你下载的文件路径/pygame-xxx-cp314-none-win_amd64.whl

最后验证安装

做完上面的步骤后,再试试安装命令,要是之前提示site-packages不可写,加上--user参数:

pip install --user pygame

内容的提问来源于stack exchange,提问作者KWincki

火山引擎 最新活动