MENU
プログラミング
PR

pygameがimportできない時の原因10選｜ModuleNotFoundErrorの解決法【VSCode対応】

ながみえ
本記事には広告（アフィリエイトリンク）が含まれます。リンク経由で申込が発生した場合、当サイトが報酬を受け取る可能性があります。

Pythonでゲーム開発やGUIプログラミングを学ぼうとするとき、最初の一歩として多くの人が導入するのが pygame です。

しかし、いざ import pygame と入力して実行すると、次のようなエラーが出て戸惑う方が少なくありません。

ModuleNotFoundError: No module named 'pygame'

「ちゃんとインストールしたのに、なぜimportできないの？」

そう思って検索する人が後を絶ちません。

実はこの問題、単純なインストールミスだけでなく、環境差・ファイル名の衝突・仮想環境の設定ミスなど、さまざまな要因によって引き起こされます。

本記事では、VSCode環境を中心にpygameがimportできない原因を10個に整理し、それぞれの状況に応じた解決策を分かりやすく解説します。

どのケースに該当するかを確認しながら、確実に問題を解決していきましょう。

あわせて読みたい
PythonとPygameで始めるゲーム制作｜初心者用の学習記事で楽しくステップアップ！
PythonとPygameで始めるゲーム制作｜初心者用の学習記事で楽しくステップアップ！
あわせて読みたい
【pygame】チャプター1-1：インストールからサンプルゲーム体験まで
【pygame】チャプター1-1：インストールからサンプルゲーム体験まで
スポンサーリンク

もくじ

pygameがimportできないときに出るエラーメッセージ

pygameのimportが失敗したときに最もよく表示されるのが、以下のエラーメッセージです。

ModuleNotFoundError: No module named 'pygame'

または、場合によっては次のような表示になることもあります。

ImportError: No module named 'pygame'

どちらも意味としてはほぼ同じで、Pythonが「pygame」というモジュールを見つけられないことを示しています。

この時点で「pygameがインストールされていない」か、「別のPython環境にインストールされている」かのどちらかであることがほとんどです。

エラーメッセージの読み方

Pythonのエラーメッセージは、「どのファイルで」「どんな原因で」問題が起きたかを順番に表示します。

最後の行に「ModuleNotFoundError: No module named ‘pygame’」とあれば、Pythonがpygameを探したが、現在の環境の中に見つからなかったという意味です。

つまり、単に「pygameがない」というよりも、“今実行しているPython環境” がpygameを認識していないということになります。

まず確認すべきポイント

次のコマンドを実行して、pygameがインストールされているかを確認してみましょう。

pip show pygame

結果として以下のような出力が出れば、pygameはすでにインストールされています。

Name: pygame
Version: 2.5.2
Location: C:\Users\<user>\AppData\Local\Programs\Python\Python312\Lib\site-packages

何も表示されなかった場合は、まだpygameがインストールされていない、もしくは別のPython環境にインストールされている可能性が高いです。

それでは、楽しく学べるpygameの世界へ飛び込んでみましょう！

よくある原因10選（VSCodeユーザー中心）

ここからは、pygame が import できないときに考えられる代表的な原因を 10 個に分けて紹介します。

VSCode での開発を想定しつつ、仮想環境を利用している場合にも対応できるように解説しています。

pygameがインストールされていない

最も基本的な原因は、単純に pygameがまだインストールされていない というものです。

Pythonの標準ライブラリにはpygameは含まれていないため、自分で追加する必要があります。

対処法：

VSCode のターミナルを開き、以下のコマンドを実行します。

pip install pygame

インストール後、次のコマンドでバージョンが表示されれば成功です。

python -m pygame.examples.aliens

これで簡単なデモゲームが起動すれば、pygameのインストールは正常に完了しています。

仮想環境にpygameがインストールされていない

VSCodeでは、プロジェクトごとに仮想環境（venv）を使っている方も多いでしょう。

この場合、仮想環境をアクティブにしていない状態でインストールすると、別の場所にpygameが入ってしまうことがあります。

対処法：

仮想環境を有効化します（例：Windows）

    .venv\Scripts\activate

    macOS/Linux の場合は：

    source .venv/bin/activate

    その状態で再度インストールしましょう。

    pip install pygame

    VSCode の右下に表示されている Python 環境名が .venv になっているか確認しましょう。

    VSCodeで選択されているPython環境が異なる

    VSCode では複数の Python がインストールされていると、想定と違う環境でプログラムを実行してしまうことがあります。

    この場合、別環境にpygameが入っていても、選択中の環境には存在しないため import に失敗します。

    対処法：

    1. VSCode のコマンドパレット（Ctrl + Shift + P）を開く
    2. 「Python: Select Interpreter」を検索して選択
    3. 表示される環境リストの中から、pygameをインストールした環境を選択

    確認のため、ターミナルで次のコマンドを実行します。

    python -m site

    出力されたパスが、pygameのインストール先と一致しているかを確認しましょう。

    ファイル名が「pygame.py」になっている

    意外と多いのがこのパターンです。

    Pythonはモジュールをファイル名で識別するため、自分のスクリプトが pygame.py という名前だと、本物のpygameモジュールではなく自分のファイルを読み込もうとして失敗します。

    対処法：

    • 自分のファイル名を pygame_test.py など別の名前に変更する
    • 同じフォルダ内にできた pygame.pyc や __pycache__ フォルダを削除する

    これで、Pythonが本来のpygameモジュールを正しく参照できるようになります。

    pipとpythonコマンドの対応がズレている

    システムに複数のPythonがインストールされている場合、pip が別のバージョンを参照していることがあります。

    たとえば、python はPython 3.11を使っているのに、pip はPython 3.8に紐づいているというようなケースです。

    対処法：

    次のように python -m pip 形式でインストールを実行しましょう。

    python -m pip install pygame

    この方法なら、現在のPython実行環境に確実にpygameがインストールされます。

    あわせて読みたい
    PythonとPygameで始めるゲーム制作｜初心者用の学習記事で楽しくステップアップ！
    PythonとPygameで始めるゲーム制作｜初心者用の学習記事で楽しくステップアップ！

    pygameがグローバル環境にしか入っていない

    グローバル環境（システム全体）にpygameを入れても、仮想環境で実行すると認識されません。

    VSCode でプロジェクトを管理している場合は、仮想環境ごとに独立してライブラリを管理するのが基本です。

    対処法：

    仮想環境を有効にしてから再インストールしてください。

    .venv\Scripts\activate
python -m pip install pygame

    PATHや環境変数の設定が不適切

    Windows環境では、Pythonをインストールした際に「PATHを追加」にチェックを入れ忘れると、コマンドが正しく動作しない場合があります。

    結果として pip や python が異なる場所を参照し、pygameのインストールがずれることがあります。

    対処法：

    コマンドプロンプトで以下を実行してPythonのパスを確認

      where python
where pip

      それぞれが同じフォルダ配下を指しているか確認し、異なる場合は再インストールまたは環境変数の修正が必要です。

      Pythonのバージョンが古い

      pygameは一部の古いPythonバージョン（例：3.6以前）ではサポートされていません。

      最新のpygameを使うには、基本的に Python 3.8 以降 が推奨されています。

      対処法：

      公式サイトから最新のPythonをインストールしましょう。

      その後、再度仮想環境を作り直してpygameをインストールします。

      pipのバージョンが古く、pygameが正しくインストールされない

      古い pip では依存関係の解決に失敗し、インストールが途中で止まることがあります。

      対処法：

      pipを最新版にアップグレードしてから、再度pygameをインストールします。

      python -m pip install --upgrade pip
python -m pip install pygame

      別の仮想環境でpygameをインストールしている

      複数のプロジェクトを扱っていると、仮想環境が複数存在するのが一般的です。

      しかし、別の環境でインストールしたpygameは、他の環境からは参照できません。

      対処法：

      • VSCodeの右下ステータスバーで「Python環境名」を確認
      • 必要であれば、環境を切り替えて再インストール

      コマンドラインでも確認可能です。

      where python
pip list

      両方の結果が一致していれば、正しい環境で動作しています。

      あわせて読みたい
      PythonとPygameで始めるゲーム制作｜初心者用の学習記事で楽しくステップアップ！
      PythonとPygameで始めるゲーム制作｜初心者用の学習記事で楽しくステップアップ！

      pygameのインストール確認とテストコード

      ここまでの手順でpygameをインストールまたは再インストールできたら、次は本当にimportできるか、そして正常に動作するかを確認しましょう。

      単にエラーが出ないだけでなく、pygameの内部機能が正しく動くかをチェックすることが重要です。

      pygameのバージョン確認

      まずは、pygameが現在の環境に正しくインストールされているかを確認します。

      コマンドで確認する方法：

      VSCode のターミナルで次のコマンドを実行します。

      python -m pygame.ver

      または以下のPythonコードを実行してもOKです。

      import pygame
print(pygame.ver)

      出力例：

      2.5.2 (SDL 2.26.5, Python 3.12.4)

      このようにバージョン情報が表示されれば、pygameはインポート可能な状態です。

      ここでエラーが出た場合は、まだ環境が適切に設定されていない可能性があります。

      その場合は第2章のチェック項目に戻って原因を再確認してください。

      pygameの動作確認を行う

      インポートが成功したら、次に ウィンドウを開いてみる簡単な動作確認 を行います。

      以下のコードを新しいファイル（例：pygame_test.py）として保存し、実行してみましょう。

      import pygame
import sys

# pygameの初期化
pygame.init()

# ウィンドウを作成
screen = pygame.display.set_mode((400, 300))
pygame.display.set_caption("pygame test")

# メインループ
while True:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            pygame.quit()
            sys.exit()
    # 背景を塗りつぶす（RGBカラー）
    screen.fill((100, 150, 200))
    pygame.display.update()

      実行結果：

      • 「pygame test」というタイトルの小さなウィンドウが開けば成功です。
      • ウィンドウを閉じるとプログラムが終了します。

      この段階で次のようなエラーが出る場合があります：

      pygame.error: video system not initialized

      これは、pygame.init() の呼び出しがない、または初期化が正しく行われていないときに発生するエラーです。

      上記コードのように、pygame.init() を最初に呼び出すことを忘れないようにしましょう。

      pygame.examplesを使って公式デモを実行する

      pygameには、動作確認に便利な公式サンプルがいくつか含まれています。

      これを使えば、pygameの描画・サウンド機能がすべて正常に動いているかを一度にチェックできます。

      コマンドで実行：

      python -m pygame.examples.aliens

      このコマンドを実行すると、シンプルなシューティングゲームが起動します。

      ここまで動作すれば、pygameが完全に動作していると判断して問題ありません。

      また、当サイトのオリジナルゲーム：SuperNekoWorldのデモ版も無料配布していますので、良ければ是非↓↓のリンクから移動して遊んでみて下さい。

      あわせて読みたい
      【pygame】チャプター1-1：インストールからサンプルゲーム体験まで
      【pygame】チャプター1-1：インストールからサンプルゲーム体験まで

      importが成功してもエラーが出る場合の補足

      「import pygame」は成功するのに、ウィンドウが開かない／描画が止まる場合は、別の原因が考えられます。

      代表的なものは次のとおりです。

      現象主な原因対処法
      ウィンドウが一瞬で閉じるpygame.event.get()がないメインループ内でイベント処理を入れる
      画面が真っ黒で更新されないpygame.display.update()を忘れているループの最後に追加
      音が出ないmixer初期化エラーpygame.mixer.init()を明示的に呼ぶ

      これらはpygameの基本的な制御構造を理解すれば簡単に解決できます。

      「importできた＝pygameが使える」ではなく、「初期化して描画できる」まで確認しておくことが大切です。

      確認後の環境バックアップもおすすめ

      pygameの動作確認が完了したら、現在の環境をバックアップしておくと安心です。

      特に仮想環境を使っている場合、再構築に備えてライブラリ一覧を保存しておきましょう。

      コマンド例：

      pip freeze > requirements.txt

      これで現在の環境に入っているパッケージ一覧が requirements.txt に出力されます。

      別のPCや環境で再現したいときは、以下のコマンドで同じ環境を再現できます。

      pip install -r requirements.txt

      それでも解決しない場合のチェックポイント

      ノートパソコンの前で頭を抱えて悩んでいる男性。デスクにはキーボード、スマートフォン、書類などが置かれており、背景には本棚や観葉植物が見える。

      ここまでの手順をすべて実行しても ModuleNotFoundError が解消しない場合、問題はより根本的な部分にあるかもしれません。

      ここでは、環境そのものの破損・設定不整合・キャッシュ問題など、見落としがちなポイントを順番に確認していきます。

      パッケージキャッシュをクリアする

      Pythonのパッケージ管理ツールである pip は、一度ダウンロードしたパッケージをキャッシュに保存しています。

      これが破損していると、pygameが正しく再インストールされない ことがあります。

      対処法：

      以下のコマンドでキャッシュを完全に削除します。

      pip cache purge

      その後、再インストールを実行します。

      python -m pip install --force-reinstall pygame

      --force-reinstall オプションは、既存のインストールを無視して再構築を行うため、依存関係の問題がリセットされます。

      仮想環境を作り直す

      仮想環境（venv）の内部が破損している場合、pygameをインストールしても認識されないことがあります。

      とくに長期間同じ環境を使っている場合や、複数のパッケージをアンインストールした後に発生しやすいです。

      対処法：

      １．既存の仮想環境を削除します。

        rm -rf .venv

        ２．新しく仮想環境を作り直します。

        python -m venv .venv

        ３．新しい環境をアクティブにしてpygameをインストール。

        .venv\Scripts\activate  # Windows
source .venv/bin/activate  # macOS/Linux
python -m pip install pygame

        これでほとんどの環境依存トラブルは解消されます。

        VSCodeのPythonインタプリタ設定をリセット

        VSCode内部でPythonインタプリタの設定が壊れている場合、どんなに正しい環境を使っても認識されないことがあります。

        これは特に、Python拡張機能を複数回再インストールした後に発生することがあります。

        対処法：

        1. VSCodeの 設定 (Ctrl + ,) → Python: Default Interpreter Path を検索
        2. 設定値を一度空にして保存
        3. コマンドパレットで再度「Python: Select Interpreter」を選び直す

        また、settings.json に古い環境パスが残っている場合は削除してください。

        権限（Permission）問題を確認する

        WindowsやmacOSの一部環境では、Pythonのインストールディレクトリに書き込み権限が不足している場合があります。

        特に、管理者権限でインストールしたPythonを一般ユーザー権限で操作している場合などに起こります。

        対処法：

        コマンドプロンプトまたはターミナルを管理者権限で開き、以下のように実行します。

        python -m pip install pygame --upgrade --user

        --user オプションを付けることで、現在のユーザー領域にpygameをインストールできます。

        これで権限関連の問題を回避できます。

        Pythonのインストールそのものを再構築する

        まれに、Python自体の設定ファイルやレジストリ情報が壊れているケースがあります。

        この場合は、Pythonを完全にアンインストールしてから再インストールするのが最も確実です。

        手順：

        1. 既存のPythonをアンインストール
        2. 公式サイトから最新版（例：Python 3.12）をダウンロード
        3. インストール時に 「Add Python to PATH」 に必ずチェックを入れる
        4. 再度仮想環境を構築し、pygameをインストール

        これで環境の再構築が完了します。

        複数Pythonバージョンの競合を確認

        python と python3 が別のバージョンを指しているケースもよくあります。

        たとえば、macOSでは python がシステムの古いバージョン（2.x）を指していることがあります。

        対処法：

        以下のコマンドでバージョンを確認します。

        python --version
python3 --version

        結果が異なる場合、pygameを使いたいバージョン側にインストールしましょう。

        python3 -m pip install pygame

        環境をリセットしても解決しないときの最終手段

        ここまで行っても解決しない場合、次のような根本的なチェックを行いましょう。

        • VSCodeの拡張機能「Python」を一度削除して再インストール
        • システム全体でPythonが複数入っていないか確認
        • 別のIDE（例：PyCharm, IDLE）でimportできるかテスト

        他の環境でimportが成功する場合は、VSCode側の設定が原因と考えられます。

        まとめ｜環境を整理すればpygameは必ず動く

        ここまで見てきたように、「pygameがimportできない」という問題の原因は、単一ではなく複数の要素が重なって起こることがほとんどです。

        しかし、正しく順序立てて確認していけば、必ず解決にたどり着くことができます。

        原因をもう一度振り返る

        以下の表は、今回紹介した主な原因と解決方法を簡単にまとめたものです。

        原因主な現象対処法
        pygameが未インストールNo module named 'pygame'pip install pygame
        仮想環境に未導入importエラー.venvをアクティブ化後に再インストール
        Python環境の選択ミスVSCodeで別環境を使用「Python: Select Interpreter」で正しい環境を選択
        ファイル名がpygame.pyモジュール衝突ファイル名変更＋__pycache__削除
        pip/pythonのズレinstall済でもimport不可python -m pip install pygame
        グローバル環境のみ導入仮想環境でimport不可仮想環境内で再インストール
        PATH設定ミスpip/pythonの場所が異なるPATH再設定または再インストール
        Pythonが古いインストール失敗Python 3.8以上を推奨
        pipが古いinstall時に警告python -m pip install --upgrade pip
        環境破損何をしても解決しない仮想環境またはPython自体を再構築

        この表を確認しながら、どこで問題が起きているかを切り分けることが大切です。

        特にVSCodeでは、Python環境が複数存在しているケースが最も多いため、まずはそこから確認すると良いでしょう。

        最後に：pygameのトラブルは「学びの通過点」

        プログラミングの学習を始めたばかりの頃は、「環境構築」でつまずくことが多いものです。

        ですが、今回のようにトラブルを一つずつ解決していく過程は、実は非常に重要な経験でもあります。

        pygameを正しく動かすために行った「仮想環境の理解」「pipの扱い」「PATHの確認」は、今後のPython開発全般で必ず役立ちます。

        環境が整理されていれば、どんなライブラリもスムーズに導入できます。

        ぜひ今回の経験を次のステップに活かしてください。

        あわせて読みたい
        PythonとPygameで始めるゲーム制作｜初心者用の学習記事で楽しくステップアップ！
        PythonとPygameで始めるゲーム制作｜初心者用の学習記事で楽しくステップアップ！
        あわせて読みたい
        【pygame】チャプター1-1：インストールからサンプルゲーム体験まで
        【pygame】チャプター1-1：インストールからサンプルゲーム体験まで
        スポンサーリンク
        ABOUT ME
        ながみえ
        ながみえ
        記事URLをコピーしました