node-gyp · npm
報錯原文
gyp ERR! build error
這是什麼意思
某個相依裡含有 C 或 C++ 程式碼,安裝時必須在你的機器上編譯,而這次編譯失敗了——node-gyp 需要編譯器和 python。這發生在完全沒裝編譯工具鏈的時候,或者這個套件比你的 node 老、標頭檔已經對不上的時候。裝上工具鏈:macOS 上用 xcode-select --install 裝命令列工具,Debian 或 Ubuntu 上裝 build-essential 和 python3,Windows 上裝 Visual Studio 的 C++ 工作負載。如果這個套件的新版本為你的 node 提供了預先編譯的二進位檔,升級這個套件比修編譯環境快得多。
怎麼修
這個沒有一行命令能解決。說明裡寫了該看哪裡。
- 來自
- node-gyp
- npm
- 20
npm 的原因寫在第一行 code XXXX 裡,而不是最後那六行 npm ERR!;如果失敗來自相依樹或原生編譯而不是你自己的程式碼,刪掉 node_modules 重新安裝就能解決一半。
怎麼讀報錯
- 從第一行往下讀。越往下越是工具內部的事,起因通常寫在最上面。
- 有檔名和行號就從那裡查——不是堆疊最上面那一格,而是最上面那條提到你自己寫的檔案的行。
- 把報錯原文照樣去搜,但先去掉你自己的路徑和變數名,正是那些讓搜尋比對不上。
- 同一種情況在不同版本裡措辭不同。結果不對頭,就把版本號一起加進查詢。
- 貼上修法之前,先確認它會丟掉什麼。這裡面有些是不能收回的。
常見問題
Q. “gyp ERR! build error” 是什麼意思?
某個相依裡含有 C 或 C++ 程式碼,安裝時必須在你的機器上編譯,而這次編譯失敗了——node-gyp 需要編譯器和 python。這發生在完全沒裝編譯工具鏈的時候,或者這個套件比你的 node 老、標頭檔已經對不上的時候。裝上工具鏈:macOS 上用 xcode-select --install 裝命令列工具,Debian 或 Ubuntu 上裝 build-essential 和 python3,Windows 上裝 Visual Studio 的 C++ 工作負載。如果這個套件的新版本為你的 node 提供了預先編譯的二進位檔,升級這個套件比修編譯環境快得多。
Q. 怎麼修?
沒有一行命令能解決。上面的說明寫了該看哪裡。
Q. 這是哪個工具報的?
node-gyp。它屬於npm,報錯原文有 4 個詞。