サイトアイコン GAMEWORKS LAB

Pygame入門 — インストールと環境準備

チャラ

前提と推奨準備

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()

トラブルシューティング

ウィンドウが表示されない、インポートエラーが出る、または音声や画像の読み込みでエラーが出る場合は、以下を確認してください。

公式情報 https://www.pygame.org/docs/ （API リファレンス等）
Getting Started https://www.pygame.org/wiki/GettingStarted
モバイルバージョンを終了