部品の組み立てに失敗した(node-gyp)
gyp ERR! build error gyp ERR! stack Error: `make` failed with exit code: 2
ひとことで言うと
「その部品はパソコンの中で組み立てる必要があるけれど、組み立てる道具が足りません」という意味です。
よくある原因
- Mac で「Xcode コマンドラインツール」が入っていない
- Windows で「Visual Studio Build Tools」が入っていない
- Node.js が新しすぎて、その部品がまだ対応していない
自分で確かめること
- Mac なら
xcode-select --installを実行したことがあるか確かめる - エラーに出ている部品の名前を見る(bcrypt・sharp・sqlite3 など)
たいていは、こうすると直ります
Mac なら xcode-select --install を実行してから、もう一度インストールします。部品によっては、組み立て不要の別の部品(bcrypt → bcryptjs など)に変えるのもかんたんです。
AIへの伝え方
下の文をコピーして、ChatGPT・Claude・Cursor などに貼り付けてください。トップで貼り付けたエラー文があれば、自動でそれに入れかわります。
次のエラーが出て困っています。プログラミング初心者にもわかるように、原因と直し方を教えてください。必要なら、直したコードも全部見せてください。 【エラー】 gyp ERR! build error gyp ERR! stack Error: `make` failed with exit code: 2 【やったこと】 (ここに、エラーが出る前にしたことを書く。例:npm run dev を実行した) 【参考】 このエラーは「部品の組み立てに失敗した(node-gyp)」というもので、よくある原因は次のとおりです。 ・Mac で「Xcode コマンドラインツール」が入っていない ・Windows で「Visual Studio Build Tools」が入っていない ・Node.js が新しすぎて、その部品がまだ対応していない どれに当てはまるかを確かめる方法も教えてください。