前提と推奨準備
Pygame は Python のライブラリであるため、まず Python がインストールされていることを確認してください。
公式ダウンロード: https://www.python.org/downloads/
インストール時に「PATHに追加」のオプションを有効にすると、コマンドラインから簡単に実行できます。
インストール後はターミナルでバージョンを確認して下さい。
仮想環境の作成（推奨）
プロジェクトごとに依存関係を分離するため、仮想環境（venv など）の利用を推奨します。
システム環境を汚さず、複数プロジェクトで互いに影響しない開発が可能になります。
# 仮想環境の作成（Python が python コマンドで動く場合） python -m venv venv # 仮想環境の有効化（Windows） venv\Scripts\activate # 仮想環境の有効化（macOS / Linux） source venv/bin/activate
Pygame のインストール
仮想環境を有効にした状態で pip を使って Pygame をインストールします。
公式ドキュメント: https://www.pygame.org/docs/
# 仮想環境を有効にした状態で pip install pygame
インストール時の注意
特定の OS や Python のバージョンではビルド済みホイールが用意されていない場合があり、その場合は依存ライブラリのインストールやビルドツールが必要になることがあります。
エラーが出た場合は、エラーメッセージを確認して不足しているライブラリ（SDL 等）を導入してください。
動作確認（最小ウィンドウ）
インストールが成功したら、最小の Pygame プログラムを実行して動作確認を行います。
以下のコードを hello_pygame.py として保存し、実行してウィンドウが表示されることを確認してください。
ウィンドウ上で閉じる操作をすると正常終了します。
# hello_pygame.py
import pygame
import sys
pygame.init()
screen = pygame.display.set_mode((640, 480))
pygame.display.set_caption("Hello Pygame")
running = True
while running:
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False
screen.fill((30, 30, 30))
pygame.display.flip()
pygame.quit()
sys.exit()
トラブルシューティング
ウィンドウが表示されない、インポートエラーが出る、または音声や画像の読み込みでエラーが出る場合は、以下を確認してください。
- 仮想環境が有効になっているか
- pip install の出力にエラーがないか
- OS 側で必要なランタイム（SDL など）が不足していないか
- Python と Pygame の対応バージョンを確認する（公式ドキュメント参照）
| 公式情報 | https://www.pygame.org/docs/ （API リファレンス等） |
|---|---|
| Getting Started | https://www.pygame.org/wiki/GettingStarted |