本页目录

官方资料整理 Windows Linux macOS

pygame 开发与测试环境部署

用 Python 虚拟环境安装 pygame，运行官方示例与开源游戏的入口脚本。

适用项目： 引擎通用（暂未关联具体项目）

工具版本：Python 3.10+、pygame 2.5+

未标注「站长实测」的步骤请自行核验。

本篇为 pygame 通用环境教程。文档见 pygame.org。推荐始终使用 venv，避免污染系统 Python。

1. 安装 Python 与创建虚拟环境

安装 Python 3（Windows 勾选 Add to PATH）。
在项目或工作目录：

python -m venv .venv

激活：
- Windows PowerShell：.venv\Scripts\Activate.ps1
- cmd：.venv\Scripts\activate.bat
- Linux/macOS：source .venv/bin/activate

2. 安装 pygame 并验证

python -m pip install -U pip
python -m pip install pygame
python -m pygame.examples.aliens

能打开示例窗口即环境可用。若 pip 找不到轮子，核对 Python 版本是否过新/过旧，或参考官网安装说明。

3. 运行开源 pygame 项目

若有 requirements.txt：pip install -r requirements.txt。
入口常见为 main.py / run.py / python -m 包名，以 README 为准。
缺字体、音频驱动或显示后端时，按报错安装系统依赖（Linux 较常见）。
不要把 .venv 提交进 Git。