🎹 Python钢琴节奏大师 · 第2章

系列：Python钢琴节奏大师：从零到游戏开发实战^[1]章节：第2章 / 共12章标题：游戏引擎篇-用Pygame打开你的第一个游戏窗口上一章：第1章-环境搭建篇^[2]下一章：第3章-绘图基础篇^[3]

认识Pygame——给Python装上"游戏引擎"

今日目标：安装Pygame库，创建第一个游戏窗口（800x600像素的黑色窗口），理解游戏循环的基本概念。

💡 本章核心：给Python装上游戏引擎，打开图形世界的大门

🎹 效果预览

完成本篇学习后，你将看到一个这样的窗口：

┌────────────────────────────────────┐│                                    ││                                    ││         （一个黑色的窗口）            ││                                    ││                                    │└────────────────────────────────────┘      800像素宽 × 600像素高

虽然只是一个黑窗口，但它已经是一个真正的游戏窗口了！明天我们就在这个窗口里画出钢琴键盘。

🤔 什么是Pygame？

上一篇我们学会了用Python打印文字，但要做出带图形的游戏，还需要一个专门的工具包——Pygame。

用比喻理解

想象你要盖房子：

• Python = 建筑材料和基本工具（水泥、砖头、锤子）
• Pygame = 专业的建筑机械（挖掘机、起重机、混凝土搅拌机）

有了Pygame，做图形游戏就简单多了！

Pygame能帮我们做什么？

🛠️ 第一步：安装Pygame

打开命令提示符

Windows：

1. 按 Win + R 键
2. 输入 cmd，回车
3. 打开黑色窗口（命令提示符）

Mac：

1. 打开"启动台"
2. 找到"终端"（在"实用工具"里）

安装命令

在命令提示符/终端中输入：

pip install pygame

然后按回车，等待安装完成。

你会看到类似这样的输出：

Collecting pygame  Downloading pygame-2.5.2-cp311-cp311-win_amd64.whl (10.8 MB)     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 10.8/10.8 MB 2.3 MB/s eta 0:00:00Installing collected packages: pygameSuccessfully installed pygame-2.5.2

看到 "Successfully installed pygame" 就表示安装成功了！

验证安装

在命令提示符中输入：

python -c "import pygame; print(pygame.__version__)"

如果显示版本号（如 2.5.2），说明Pygame安装成功！

❓ 安装常见问题

Q1：显示"pip不是内部或外部命令"

原因：第1篇安装Python时没勾选"Add to PATH"

解决方法：

1. 找到Python的安装位置（默认是 C:\Users\你的用户名\AppData\Local\Programs\Python\Python311）
2. 在该文件夹下找到 Scripts 文件夹
3. 在地址栏输入 cmd，回车
4. 再运行 pip install pygame

或者更简单：重新安装Python，记得勾选"Add to PATH"

Q2：安装很慢或失败

原因：pip默认从国外服务器下载

解决方法：使用国内镜像源

pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple

Q3：Mac上显示"Permission denied"

解决方法：在命令前加 sudo

sudo pip3 install pygame

然后输入电脑密码（输入时不会显示，输完按回车）

📝 第二步：创建第一个游戏窗口

打开IDLE，新建文件

1. 打开IDLE（开始菜单搜索"IDLE"）
2. 点击 File → New File（文件→新建文件）
3. 保存文件为 02_pygame_window.py

完整代码

输入以下代码：

# 导入pygame库import pygame# 初始化pygamepygame.init()# 设置窗口大小：宽800像素，高600像素SCREEN_WIDTH = 800SCREEN_HEIGHT = 600# 创建游戏窗口screen = pygame.display.set_mode((SCREEN_WIDTH, SCREEN_HEIGHT))# 设置窗口标题pygame.display.set_caption("我的钢琴游戏")# 游戏主循环running = Truewhile running:# 处理事件（如关闭窗口、按键等）for event in pygame.event.get():# 如果点击了关闭按钮（X）if event.type == pygame.QUIT:            running = False# 填充背景为黑色（RGB: 0, 0, 0）    screen.fill((0, 0, 0))# 更新屏幕显示    pygame.display.flip()# 退出pygamepygame.quit()

运行程序

按 F5 或点击 Run → Run Module。

你会看到一个黑色的窗口，标题是"我的钢琴游戏"。

点击窗口右上角的 X 可以关闭窗口。

🎉 恭喜你！你创建了第一个游戏窗口！

🔍 代码逐行解析

让我们逐行理解这段代码：

第1行：导入Pygame

import pygame

告诉Python："我要使用Pygame这个工具包了"。

就像画画前要拿出画笔一样，编程前要先"导入"需要的工具。

第4行：初始化Pygame

pygame.init()

init 是 "initialize"（初始化）的缩写。

这行代码让Pygame做好所有准备工作，比如检查显卡、声卡等。

必须调用这行，否则Pygame无法正常工作！

第7-8行：定义窗口大小

SCREEN_WIDTH = 800SCREEN_HEIGHT = 600

这里我们定义了两个常量（不变的值）：

• 窗口宽度 = 800像素
• 窗口高度 = 600像素

使用大写字母命名是约定，表示这些值不会被修改。

什么是像素？

像素是屏幕上的最小显示单位。你可以把屏幕想象成由很多小方格组成的网格，每个小方格就是一个像素。

800×600表示：

• 横向有800个小方格
• 纵向有600个小方格

第11行：创建窗口

screen = pygame.display.set_mode((SCREEN_WIDTH, SCREEN_HEIGHT))

这行代码创建游戏窗口：

• pygame.display 是Pygame中负责"显示"的模块
• set_mode() 是创建窗口的函数
• 括号里传入窗口的宽和高（用一个元组(800, 600) 表示）
• screen 是我们给这个窗口起的名字，后面要用它来操作窗口

💡 注意：(800, 600) 外面有一层括号，set_mode() 外面也有一层括号，不要搞混了！

第14行：设置窗口标题

pygame.display.set_caption("我的钢琴游戏")

设置窗口顶部显示的标题文字。

你可以改成任何你喜欢的名字，比如：

• "Python钢琴大师"
• "小明的钢琴游戏"
• "最强音游"

第17-28行：游戏主循环

这是最重要的部分！

running = Truewhile running:# ... 循环体内的代码

什么是循环？

想象你在操场上跑步：

• 一圈又一圈，不停重复
• 直到老师说"停"，你才停下来

这就是循环！

游戏为什么需要循环？

游戏画面是动态变化的：

• 音符在往下掉
• 琴键被按下会变色
• 分数在实时更新

这些都需要每秒钟更新很多次（通常是60次），才能形成流畅的动画效果。

while循环详解

running = True# 设置一个标志，表示游戏正在运行while running:          # 只要running是True，就一直循环# 循环体内的代码每帧执行一次if event.type == pygame.QUIT:  # 如果用户点击关闭按钮        running = False# 把running改成False，下次循环就会停止

第20-23行：事件处理

for event in pygame.event.get():if event.type == pygame.QUIT:        running = False

事件（Event） 是指用户做的操作，比如：

• 点击鼠标
• 按下键盘
• 关闭窗口
• 移动鼠标

pygame.event.get() 获取当前发生的所有事件，我们用 for 循环逐个检查。

pygame.QUIT 是"关闭窗口"事件。当用户点击窗口的 X 按钮时，我们把 running 设为 False，游戏循环就会结束。

💡 为什么必须处理QUIT事件？

如果不处理，点击 X 按钮窗口关不掉，程序会卡住！

第26行：填充背景

screen.fill((0, 0, 0))

把窗口背景填充为黑色。

(0, 0, 0) 是RGB颜色值：

• 第一个0：红色（Red）的强度，0-255
• 第二个0：绿色（Green）的强度，0-255  
• 第三个0：蓝色（Blue）的强度，0-255

(0, 0, 0) = 没有红、没有绿、没有蓝 = 黑色

(255, 255, 255) = 全红+全绿+全蓝 = 白色

(255, 0, 0) = 只有红 = 红色

第29行：更新显示

pygame.display.flip()

把我们在内存中画好的内容，真正显示到屏幕上。

可以这么理解：

• 我们在"后台画布"上画画
• flip() 把后台画布"翻"到前面，让玩家看到

第32行：退出Pygame

pygame.quit()

游戏结束后，清理Pygame占用的资源，优雅地退出。

🎨 动手改造：换个颜色

试着修改第26行，把背景改成其他颜色：

# 白色背景screen.fill((255, 255, 255))# 红色背景screen.fill((255, 0, 0))# 蓝色背景screen.fill((0, 0, 255))# 绿色背景screen.fill((0, 255, 0))# 黄色背景（红+绿）screen.fill((255, 255, 0))# 紫色背景（红+蓝）screen.fill((255, 0, 255))

每次修改后按 F5 运行，看看效果！

🖼️ 游戏循环流程图

┌─────────────────┐│   开始游戏      │└────────┬────────┘         ▼┌─────────────────┐│ 初始化pygame    ││ 创建窗口        │└────────┬────────┘         ▼┌─────────────────┐     否│  running=True?  │────────→ 结束游戏└────────┬────────┘         │ 是         ▼┌─────────────────┐│  处理用户事件   ││  (按键、关闭等) │└────────┬────────┘         ▼┌─────────────────┐│  更新游戏状态   ││  (位置、分数等) │└────────┬────────┘         ▼┌─────────────────┐│  绘制画面       ││  (背景、角色等) │└────────┬────────┘         ▼┌─────────────────┐│  显示到屏幕     │└────────┬────────┘         │         └─────────────┐                       │         ◄─────────────┘

这就是游戏循环！每秒钟循环60次，画面就流畅了。

❓ 常见问题

Q1：运行后窗口一闪就消失了

原因：程序执行完就退出了，没有进入循环

检查：确保有 while running: 循环，并且循环内有 pygame.display.flip()

Q2：窗口无法关闭，卡住了

原因：没有处理 pygame.QUIT 事件

检查：确保有这段代码：

for event in pygame.event.get():if event.type == pygame.QUIT:        running = False

Q3：显示"ModuleNotFoundError: No module named 'pygame'"

原因：Pygame没有安装成功

解决：回到第一步，重新安装Pygame

Q4：窗口标题没有变

检查：set_caption() 要在 set_mode() 之后调用，确保拼写正确

Q5：Mac上运行报错

尝试：把 python 改成 python3

python3 02_pygame_window.py

🎯 课后练习

练习1：改变窗口大小

把窗口改成 1000×800，看看有什么变化。

练习2：改变窗口标题

把标题改成你自己的名字，比如 "小明的钢琴游戏"。

练习3：改变背景颜色

把背景改成你喜欢的颜色，尝试不同的RGB组合。

练习4（挑战）：彩色渐变

试着让背景颜色每帧都变化（提示：需要用到变量和数学计算）。

🎬 下篇预告

第3篇：《用坐标画画——Pygame绘制基础》

明天我们将：

• 理解屏幕坐标系（x和y轴）
• 学习绘制矩形 rect()
• 学习绘制圆形 circle()
• 学习绘制线条 line()

这是画钢琴键盘的基础，一定要来哦！

📦 本课资源

• 完整代码：02_pygame_window.py
• 关键命令：
• 安装Pygame：pip install pygame
• 验证安装：python -c "import pygame; print(pygame.__version__)"
• 核心概念：
• pygame.init() - 初始化
• set_mode() - 创建窗口

本系列文章面向零基础中小学生，每篇都有详细步骤和配图说明。遇到问题欢迎在评论区留言！代码文件关注回复“钢琴”免费获取下载地址。