pygame安装

Pygame 安装指南（Python 3.x）：照着做，5 分钟跑起来

Pygame 是 Python 里最常用的游戏开发库——画图、放音乐、响应键盘鼠标，一套搞定。

但安装这件事，对新手来说往往是最劝退的。这篇指南把安装步骤拆到最细，遇到问题怎么处理也写清楚了。照着做，5 分钟让 Pygame 跑起来。

用 pip 安装（最推荐的方式）

Pygame 已经在 PyPI 官方仓库里了，直接用 pip 安装。

1. 打开终端

Windows：按 Win + R，输入 cmd，回车
Mac：按 Cmd + 空格，输入 Terminal，回车
Linux：按 Ctrl + Alt + T，或从应用菜单打开终端

2. 执行安装命令

如果你的电脑里同时装了 Python 2 和 Python 3，用 pip3 确保装到 Python 3 的环境里：

1	pip3 install pygame

如果只装了 Python 3，用 pip 也行：

1	pip install pygame

3. 验证安装

1	python3 -m pygame --version

看到类似这样的输出就说明装好了：

1	pygame 2.5.2 (SDL 2.28.3, Python 3.11.4)

常见问题及解决办法

问题1：安装速度太慢，甚至超时报错

默认用的是国外源，换成国内镜像秒解决：

# 阿里云
pip3 install pygame -i https://mirrors.aliyun.com/pypi/simple/

# 清华源
pip3 install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple/

问题2：Permission denied（权限不足）

Mac 或 Linux 上可能出现这个提示，用 --user 装到当前用户目录就行：

1	pip3 install pygame --user

问题3：macOS 上缺少 SDL 库

Pygame 底层依赖 SDL 多媒体库。如果装完跑不起来，用 Homebrew 装上：

1	brew install sdl2 sdl2_image sdl2_mixer sdl2_ttf

然后重新 pip install pygame 即可。

问题4：Linux（Ubuntu/Debian）上缺少系统依赖

先装系统依赖，再装 Pygame：

1
2
3

sudo apt-get update
sudo apt-get install python3-dev libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev
pip3 install pygame

问题5：装到虚拟环境里，激活后装

如果你用虚拟环境（强烈推荐），先激活再安装：

1 2	source .venv/bin/activate # 激活 pip install pygame # 装到虚拟环境里

测试：写 20 行代码验证是否能用

安装完后，把下面这段代码存成 test.py，运行一下：

import pygame
import sys

pygame.init()

screen = pygame.display.set_mode((400, 300))
pygame.display.set_caption("Pygame 测试")

running = True
while running:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False
    
    screen.fill((255, 255, 255))
    pygame.draw.rect(screen, (255, 0, 0), (150, 100, 100, 50))
    pygame.display.flip()

pygame.quit()
sys.exit()

运行：

1	python3 test.py

如果弹出一个白色背景的窗口，中间有个红色方块，说明 Pygame 跑通了。

如果报错 ModuleNotFoundError: No module named 'pygame'，说明没装对，回头检查上面的步骤。

如果窗口闪一下就消失，检查代码里是否有 pygame.display.flip() 和事件循环。