python-pygame

python

Python pygame(GUI 编程)模块最完整教程（1）



Python-ZZY

原创

关注

17 点赞·5077 人阅读

提示：下滑文章左侧可以查看目录！

pygame 是 python 中一个流行的 GUI 编程模块，是专门为了开发游戏而设计的。这是一个第

三方模块，是 SDL 语言和 Python 的接口。

pygame 的最新官网是：https://pyga.me/

pygame 以前的官网是：https://www.pygame.org/

1.2 pygame 的优势

pygame 的核心功能使用的是 C 代码，大大提高了运行的速度。

pygame 支持在大部分操作系统运行，可跨平台，在经过编译后可以在 Andriod 手机和网页

上运行。

1.3 安装 pygame

pygame 是一个第三方模块，这意味着需要在安装后才能使用。

使用 pip 工具就可以安装，在 cmd 输入后按下回车，稍等一会儿：

pip install pygame-ce

复制

注意：此处的 pygame-ce 是 pygame 官方的社区编辑版，推荐使用。普通版的 pygame 可用 pip

install pygame 安装

安装完成后，尝试导入 pygame，会打印出一段文字，提示 pygame 的版本：

在本教程中，使用的是较新版的 pygame2。

一下。

cursors 加载、编译光标图像

event 管理用户事件（如键盘、鼠标）

font 加载和绘制 TrueType 字体

gfxdraw 绘制抗锯齿的形状

image 加载、保存图片文件

key 管理键盘输入

mixer 播放声音

scrap 管理剪贴板

sprite 管理精灵

surfarray 处理图像像素数据

time 管理时间和帧率

transform 变换表面（如缩放、旋转等）

注：：：pygame 还增加了许多功能，作者后期会进行补充

pygame 中一些常用的模块会自动导入，所以大部分模块无需额外导入。

1.5 表面

pygame 可以绘制一些图片、文本。为了在窗口上显示它们，pygame 提供了一系列的方法来

导入、渲染。但在这之前，所有的绘制内容都会转化成一个 pygame.Surface 对象（表面对象，

可以理解成一张图片），这样才能进行绘制。表面由多个像素构成，是一个矩形。pygame 也

提供了一些方法处理表面。

整个 pygame 窗口除去标题栏的部分可以按照一个表面来操作。在操作表面的时候，比如要

在某个地方绘制一段文字，必然会涉及到坐标的处理。在 pygame 中，最简单的一种坐标表

screen = pg.display.set_mode((400, 400)) #建立一个 400x400 的窗口

pg.display.set_caption("Pygame 窗口")

if event.type == pg.QUIT: #如果事件为关闭窗口

复制



接下来我将对这一段代码进行解释。

2.1 初始化 pygame

pygame 使用前，首先要进行初始化操作，也就是调用 pygame.init()方法。如果不进行初始

化操作，大部分功能将无法使用，会显示一段错误提示：

pygame.error: video system not initialized

复制

除了使用 pygame 主模块，使用 pygame 的子模块有时候也需要初始化。pygame 中有一些重

要的子模块被提前导入到 pygame 主模块中，这样的模块的初始化操作会在调用 pygame.init()

的时候同时进行。

2.2 创建窗口

pygame.display.set_mode 用于配置 pygame 窗口。pygame 是单窗口的模式，这意味着在一

个 python 解释器中默认只允许创建一个窗口。pg.display.set_mode 创建一个窗口的 Surface

对象，原形如下：

set_mode(size=(0, 0), flags=0, depth=0, display=0, vsync=0) -> Surface

更多用法参见后文。

如果在后面想要更改窗口的样式，也可以调用 set_mode 方法，不过那时就不会额外创建一

个窗口了，而是直接在原先创建的窗口上更改。

2.3 更改标题

pg.display.set_caption 方法用于设置窗口的标题。

2.4 事件循环

2.5 退出 pygame

和初始化 pygame 的 init()方法相对，pygame.quit()方法用于退出 pygame 窗口。

3 基础表面操作

通过上面一个示例的学习，我们已经成功创建出一个纯黑色的窗口，但是这还远远不够，我

们还要在窗口上绘制图片、图形、文字。在 1.5 节中，我们已经了解过 pygame.Surface，知

道 pygame 的图片、窗口表面都是 Surface 对象，接下来将进一步讲解操作的方式。

3.1 fill()方法

Surface.fill 方法用于将一个表面用纯色填充。在 pygame 中，颜色的表示方式通常有两种：

(R, G, B)色彩元组或颜色名称（例如"red", "yellow"）的字符串（也可以通过 pg.color.Color 对

象，这里暂时不展开）。

import pygame as pg #导入 pygame 模块，习惯上命名为 pg

for event in pg.event.get(): #获取用户事件

if event.type == pg.QUIT: #如果事件为关闭窗口

pg.quit() #退出 pygame

复制



这个示例的大部分代码和我们的第一个示例一样，但是在 while True 循环中添加了一些代码，

运行效果如下：

需要注意的是最后一行代码 pg.display.flip()，这行代码用于更新窗口表面（窗口表面通常叫

做屏幕）。在屏幕上进行的一系列操作如果不进行刷新，则无法正确在屏幕上显示。这是窗

口表面的一个特殊之处。新手一定要注意：不要忘记刷新！除了 flip 方法，其实还有一个

update()方法也可以用于刷新，但是 flip 速度会快一点。

那么，为什么 fill 要写在循环里面呢？其实写在循环外面，然后调用一次刷新也是可以的。