Windows安装pygame?我花了3小时才搞定的血泪经验
说真的,别看现在网上教程一搜一大把,当年我第一次在Windows上装pygame的时候,差点把电脑砸了。
报错提示看得我一脸懵——什么"Unable to find vcvarsall.bat",什么"Microsoft Visual C++ Build Tools",整整折腾了三个小时才搞定。后来才发现,原来就那么几步的事儿,根本没那么复杂。
这篇文章不整虚的,直接把我踩过的坑和最靠谱的安装方法掏出来,保证你10分钟之内就能跑起来。
装pygame之前,先确认你的Python没问题
在说pygame之前,咱们先确认一下Python本尊装好了没。

打开CMD(就是那个黑框框,按Win+R,输入cmd回车),直接敲:
python --version
如果弹出版本号,比如Python 3.11.8这种,说明Python已经就位。
如果没有,先去官网下一个:https://www.python.org/downloads/。安装的时候记得勾选"Add Python to PATH",别问我为什么知道——当年没勾选的人现在都在对着环境变量怀疑人生。
pIP一般会跟Python一起装好,确认一下:
pip --version
看到版本号就行。
最简单的方式:pip大法
说白了,安装pygame就一行命令的事儿。
在CMD里输入:
pip install pygame
然后等着它自己下载、安装。网速给力的話,一两分钟就完事儿。
装完之后验证一下:
python -c "import pygame; print(pygame.__version__)"
如果弹出版本号,比如2.5.2,恭喜你,成了!
是不是特简单?但是!
总有人pip install pygame会报错,一般有两种情况:
第一种:网速太慢或者被墙了
这种情况在 国内比较常见。解决方法是换国内镜像源,一行命令搞定:
pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple
清华源,算是比较稳的一个。
第二种:提示缺少Microsoft Visual C++
有些版本的pygame需要编译,这时候会报vcvarsall.bat找不到的错误。
解决办法有两个:
-
去微软官网下载Build Tools:https://visualstudio.microsoft.com/visual-cpp-build-tools/
下载安装的时候,勾选"使用C++的桌面开发"就行。装完再
pip install pygame,基本就没问题了。 -
如果你不想装这几个G的大家伙,也可以直接去PyPI下载预编译好的whl文件:https://pypi.org/project/pygame/#files
找到对应你Python版本和Windows架构的whl文件,下载下来,然后CMD进到下载目录,执行:
pip install pygame-xxx.whl
Anaconda用户看这里
如果你用的是Anaconda,那稍微有点不一样。
在Anaconda Prompt里输入:
conda install pygame -c conda-forge
或者:
pip install pygame
其实pip也行,Anaconda对两者兼容性都不错。
常见坑,我帮你踩过了
坑1:装上了但import报错
有时候pip显示安装成功,一import pygame就报错"ModuleNotFoundError"。
试试升级pip:
python -m pip install --upgrade pip
然后重新安装。
坑2:版本不对
pygame 2.x和1.x差距还挺大的。如果你需要特定版本,可以指定安装:
pip install pygame==2.5.2
坑3:杀毒软件捣乱
偶尔会有杀毒软件把pygame的某些文件误删。如果import失败,检查一下杀毒软件隔离区。
快速验证:跑个小游戏试试
装好了总得验证一下吧?
新建一个Python文件,比如test_pygame.py,写上这几行:
import pygame
import sys
pygame.init()
screen = pygame.display.set_mode((800, 600))
pygame.display.set_caption("我的第一个pygame窗口")
running = True
while running:
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False
screen.fill((30, 30, 30)) # 深灰色背景
pygame.display.flip()
pygame.quit()
sys.exit()
保存,运行!
如果弹出一个深灰色的窗口,恭喜你,pygame已经完美就位,可以开始折腾你的游戏开发之旅了。
写在最后
安装pygame这件事,说难不难,说简单也确实有人被卡半天。核心就三点:Python装好、pip用对、该装的编译工具别漏。
搞定这些,后面就是发挥创意的事儿了。pygame官方文档写得挺详细的,照着写几个Demo,慢慢就有手感了。
行了,别的废话不说了关闭窗口去玩吧,祝你第一个游戏早日出炉!

还没有评论,来说两句吧...