開発で行き詰まった時の解決ガイド

「コードは正しいはずなのに、なぜか動かない」「環境構築の途中で謎のエラーが出て、作業が止まってしまった」といった経験はありませんか。開発を進めていると、ツールの設定やネットワークの問題で時間を浪費してしまうことがよくあります。

こうした「行き詰まった状態」から最短で抜け出すための方法を紹介します。問題を切り分け、正しい手順で対処することで、本来のコーディング作業にすぐに戻ることができます。

必要なもの

作業を始める前に、以下の環境が整っているか確認してください。

• Node.js と npm のインストール
• 正しく設定された PATH

クイックスタート

まずは、以下の 4 つのステップで問題の解決を試みるのがおすすめです。

1. 環境の健全性を確認する: Install sanity を参照して、Node.js や npm、PATH の設定が正しいかチェックしてください。
2. 自動修復を試す: Doctor ツールを実行して、システムの修復を試みます。
3. ログを調査する: Logging を確認して、エラーの詳細を把握します。
4. Gateway の状態を確認する: Gateway 関連の問題が疑われる場合は、Gateway logging をチェックしてください。

トラブルシューティング

よくある問題については、以下のリソースが役立ちます。

• 一般的なトラブルシューティング: どこから手をつければいいか分からない場合は、Troubleshooting から開始してください。
• Gateway の問題: 通信エラーなどの Gateway 固有のトラブルは、Gateway troubleshooting に解決策がまとまっています。

解決策が見つからない場合や、より具体的なアドバイスが必要な場合は、AI Setup Assistant を活用してみてください。

次のステップ

• FAQ (concepts)