node-gyp · npm
メッセージ
gyp ERR! build error
何を意味するか
依存の中に C や C++ の部分があり、設置時にその場でコンパイルする必要があるのに、そのコンパイルが失敗したという意味です。node-gyp はコンパイラと python を必要とします。ビルド道具がまったく入っていない場合、あるいはその package が自分の node より古くヘッダが合わない場合に出ます。macOS では xcode-select --install でコマンドライン道具を、Debian・Ubuntu では build-essential と python3 を、Windows では Visual Studio の C++ ワークロードを入れます。その package の新しい版が自分の node 用の事前ビルド済み実体を配っているなら、ビルド環境を直すより package を上げるほうがはるかに速いです。
直しかた
一行の命令では終わりません。何を見るべきかを説明に書いてあります。
- 出す道具
- node-gyp
- npm
- 20
npm では原因は最後の六行ではなく最初の code XXXX の一行に書かれており、失敗が自分のコードではなく依存関係の木やネイティブビルドから来ている場合は、node_modules を消して入れ直すだけで半分は解けます。
エラーメッセージの読み方
- 一行目から読みます。下に行くほど道具の内部の話で、原因はたいてい一番上に書かれています。
- ファイル名と行番号があればそこが出発点です — スタックの最上段ではなく、自分が書いたファイルが出てくる一番上の行です。
- 文句はそのまま検索します。ただし自分のパスや変数名は消します — その部分が検索を邪魔します。
- 同じ事情が道具の版ごとに違う言い方で出ます。結果が合わないときは版番号も入れてみます。
- 直す命令を貼る前に、その命令が何を捨てるかを確かめます。取り消せないものが混ざっています。
よくある質問
Q. gyp ERR! build error はどういう意味ですか。
依存の中に C や C++ の部分があり、設置時にその場でコンパイルする必要があるのに、そのコンパイルが失敗したという意味です。node-gyp はコンパイラと python を必要とします。ビルド道具がまったく入っていない場合、あるいはその package が自分の node より古くヘッダが合わない場合に出ます。macOS では xcode-select --install でコマンドライン道具を、Debian・Ubuntu では build-essential と python3 を、Windows では Visual Studio の C++ ワークロードを入れます。その package の新しい版が自分の node 用の事前ビルド済み実体を配っているなら、ビルド環境を直すより package を上げるほうがはるかに速いです。
Q. どう直しますか。
一行の命令では終わりません。何を見るべきかを上の説明に書いてあります。
Q. どの道具が出すエラーですか。
node-gyp です。npmの仲間で、文句は4語です。