Troubleshooting
トラブルシューティング & Q&A
開発に行き詰まった時の解決法と、よくある質問をまとめました。
1. AIに質問する時の鉄則
エラーが出ても焦る必要はありません。AIに「正しい情報」と「適切な指示」さえ渡せば、必ず解決策を提示してくれます。
以下の3点セットを意識してください。
- ① 現状のコード（DevToolsで全結合したもの）
- ② エラーログ（コマンドプロンプトの内容をコピー）
- ③ 「どうなってほしいか」という明確なゴール
魔法のプロンプト（治癒）：
2. よくあるエラーと対処法 (Q&A)
Q. 黒い画面が一瞬で消えてエラーが読めません。
A. コマンドプロンプトから手動実行してください。
フォルダ内で右クリックし「開発ユーティリティ > コマンドプロンプトをここで開く」を選択し、_run_debug.bat と入力してEnterを押せば、画面が閉じずにエラーを確認できます。
Q. ModuleNotFoundError: No module named '...' と出ます。
A. ライブラリがインストールされていません。
_setup.bat をもう一度実行してみてください。それでも直らない場合は、AIにエラー文を見せれば「pip install ...」というコマンドを教えてくれます。
Q. APIキーのエラー（403, 429）が出ます。
A. APIキーが無効か、制限を超えています。
system/api_key.txt を確認してください。キーが正しく貼られているか、余計な空白が入っていないか確認しましょう。また、無料枠を超えた場合は別のGoogleアカウントでキーを取得し、追記してください（ローテーション機能）。
Q. Pythonが見つからない、または動かない。
A. インストール時の設定漏れの可能性があります。
Pythonインストール時、画面下の「Add python.exe to PATH」にチェックを入れましたか？もし忘れていた場合は、一度アンインストールして入れ直すのが一番早いです。
3. それでも解決しない場合
どうしても解決できないエラーは、講師（OKIHIRO）が直接サポートします。
← ポータルへ戻る