Windows 如何安装 Pygame

关键词：Windows 安装 Pygame、Python 安装 Pygame、pIP 安装 pygame、Pygame 配置教程

Pygame 是 Python 里很常用的游戏开发库，适合做小游戏、图形界面、键盘控制、碰撞检测这类功能。很多新手第一次装的时候会卡在 Python 环境、pip 命令、版本不兼容这几个地方。下面我按最容易上手的方式，讲清楚 Windows 里怎么正确安装 Pygame。

问题分析

Windows 上安装 Pygame，本质上就是三步：

先把 Python 装对。
确认 pip 能正常用。
用 pip 安装 pygame。

看起来简单，但实际报错通常出在这几类情况：

没装 Python，或者装了但没勾选加入环境变量。
pip 不是最新，安装失败。
Python 版本太老，和新版 Pygame 不兼容。
机器上有多个 Python，命令指向了错误的版本。
装完以后，编辑器里还是找不到模块。

所以最稳妥的做法，不是上来就敲安装命令，而是先把环境整理好。

解决方案

一、先检查电脑有没有安装 Python

按下 Win + R，输入 cmd，回车打开命令提示符，然后输入：

python --version

或者：

py --version

如果能看到类似下面的结果，说明 Python 已经装好了：

Python 3.11.6

如果提示“不是内部或外部命令”，说明 Python 没装好，或者环境变量没配置。

二、安装 Python

去 Python 官网下载 Windows 版本，建议选择 Python 3.10、3.11 或 3.12 这类较新的稳定版本。

安装时要注意两点：

勾选 Add Python to PATH
直接点 Install Now，先用默认设置就行

这一步非常关键，不勾选 PATH，后面你在命令行里就容易找不到 Python 和 pip。

安装完成后，再打开命令提示符，执行：

python --version
pip --version

如果两条命令都有输出，就说明环境基本正常。

三、升级 pip

很多安装失败，不是 pygame 本身的问题，而是 pip 太旧。先升级一下：

python -m pip install --upgrade pip

如果你电脑里有多个 Python，也可以用：

py -m pip install --upgrade pip

升级完成后，再确认一次：

pip --version

四、安装 Pygame

最标准的安装命令是：

pip install pygame

如果你用的是 py 启动器，也可以写成：

py -m pip install pygame

这两种方式都可以，后者在多版本 Python 环境下更稳一些。

安装完成后，测试是否成功：

python

进入 Python 交互环境后输入：

import pygame
print(pygame.__version__)

如果能正常输出版本号，没有报错，说明安装成功。

五、写一个最小测试程序

安装好以后，最好马上做一次验证。新建一个 test_pygame.py 文件，写入下面内容：

import pygame

pygame.init()
screen = pygame.display.set_mode((640, 480))
pygame.display.set_caption("Pygame Test")

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

pygame.quit()

运行这个脚本：