← 一覧へ
準備・インストール出る場所:ターミナル(黒い画面)たまに出る

部品の組み立てに失敗した(node-gyp)

gyp ERR! build error
gyp ERR! stack Error: `make` failed with exit code: 2

ひとことで言うと

「その部品はパソコンの中で組み立てる必要があるけれど、組み立てる道具が足りません」という意味です。

よくある原因

  1. Mac で「Xcode コマンドラインツール」が入っていない
  2. Windows で「Visual Studio Build Tools」が入っていない
  3. Node.js が新しすぎて、その部品がまだ対応していない

自分で確かめること

たいていは、こうすると直ります

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 が新しすぎて、その部品がまだ対応していない

どれに当てはまるかを確かめる方法も教えてください。