pygame-community/pygame-ce
GitHub: pygame-community/pygame-ce
pygame-ce 是 pygame 的社区版分支，基于 SDL 提供 Python 跨平台多媒体与游戏开发能力，以更快的发布节奏和民主治理模式持续改进原项目。
Stars: 1546 | Forks: 247
.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg
:width: 800
:alt: pygame
:target: https://pyga.me/
|DocsStatus|
|PyPiVersion| |PyPiLicense|
|Python3| |GithubCommits| |BlackFormatBadge|
## |DiscordBadge|
Pygame_ 是一个免费的开源跨平台库，用于使用 Python 开发视频游戏等多媒体应用程序。
它使用 `Simple DirectMedia Layer library`_ 和其他几个流行的库来抽象最常用的功能，使编写这些程序成为一项更直观的任务。
本发行版被称为 **'pygame - Community Edition'**（简称 'pygame-ce'）。
它是原 pygame 项目的前核心开发者创建的一个分支，由于遇到了无法克服的挑战，阻碍了他们在原项目上的继续开发，因此创建了这个分支。
新发行版旨在提供更频繁的发布、持续的 bug 修复和增强功能，以及更民主的治理模式。
## 安装
要安装 pygame-ce，首先请确保你已安装 Python（和 pip），并且它们可用在你的 PATH 中。
然后，在你的终端或命令提示符中运行以下命令：
::
pip install pygame-ce
请注意，在某些平台上，你可能需要使用 ``pip3`` 而不是 ``pip``。
### Linux 注意事项：“Breaking System Packages” 错误
在某些 Linux 发行版（如 Ubuntu 或 Debian）上，使用 ``pip`` 安装 Python 包可能会触发类似以下的消息：
::
error: externally-managed-environment
This environment is externally managed when system packages are installed.
这意味着你的系统 Python 是由操作系统管理的，全局使用 ``pip3`` 可能会干扰系统包。
## 推荐解决方案
1. 使用 ``venv``（虚拟环境）：
你可以创建一个虚拟环境并在其中安装 pygame-ce。
这样你仍然可以使用系统 Python，但会为安装的包创建一个独立的环境，从而使它们不会与系统包发生冲突或破坏系统包。
.. code-block:: bash
python3 -m venv venv # create a venv named 'venv'
source venv/bin/activate # activate venv
pip install pygame-ce # install packages in venv
2. 使用 ``pyenv``（用户级 Python 管理）：
`pyenv `_ 允许你在用户级别安装和管理自己的 Python 版本，而无需触及系统 Python。
另外，你还可以并行安装和使用多个 Python 版本。
3. 使用 ``uv``（快速现代包安装器）：
`uv
标签：Python, SDL, 多媒体, 客户端加密, 开源库, 搜索引擎爬虫, 无后门, 游戏开发, 逆向工具