npm · npm
報錯原文
npm WARN EBADENGINE Unsupported engine
這是什麼意思
某個套件在 engines 裡宣告的 node 或 npm 版本範圍，你的環境不滿足——npm 只是警告，照樣裝上。它出現在你用的是系統套件管理器裝的舊 node，或者專案已經遷到比你 shell 裡更新的 node 的時候。用你的版本管理器把 node 切到印出來的範圍之內；該信的是專案的 .nvmrc 或 package.json 裡的 engines 欄位。預設它只是警告，但如果 .npmrc 裡有 engine-strict=true，同樣的條件就會變成中斷安裝的錯誤。
怎麼修
這個沒有一行命令能解決。說明裡寫了該看哪裡。
- 來自
- npm
- npm
- 20
npm 的原因寫在第一行 code XXXX 裡，而不是最後那六行 npm ERR!；如果失敗來自相依樹或原生編譯而不是你自己的程式碼，刪掉 node_modules 重新安裝就能解決一半。
怎麼讀報錯
- 從第一行往下讀。越往下越是工具內部的事，起因通常寫在最上面。
- 有檔名和行號就從那裡查——不是堆疊最上面那一格，而是最上面那條提到你自己寫的檔案的行。
- 把報錯原文照樣去搜，但先去掉你自己的路徑和變數名，正是那些讓搜尋比對不上。
- 同一種情況在不同版本裡措辭不同。結果不對頭，就把版本號一起加進查詢。
- 貼上修法之前，先確認它會丟掉什麼。這裡面有些是不能收回的。
常見問題
Q. “npm WARN EBADENGINE Unsupported engine” 是什麼意思？
某個套件在 engines 裡宣告的 node 或 npm 版本範圍，你的環境不滿足——npm 只是警告，照樣裝上。它出現在你用的是系統套件管理器裝的舊 node，或者專案已經遷到比你 shell 裡更新的 node 的時候。用你的版本管理器把 node 切到印出來的範圍之內；該信的是專案的 .nvmrc 或 package.json 裡的 engines 欄位。預設它只是警告，但如果 .npmrc 裡有 engine-strict=true，同樣的條件就會變成中斷安裝的錯誤。
Q. 怎麼修？
沒有一行命令能解決。上面的說明寫了該看哪裡。
Q. 這是哪個工具報的？
npm。它屬於npm，報錯原文有 5 個詞。
相關報錯
Error: error:0308010C:digital envelope routines::unsupportednode 17+npm WARN deprecated request@2.88.2: request has been deprecatednpmzsh: command not found: tscshellnpm ERR! ERESOLVE unable to resolve dependency treenpmnpm ERR! Conflicting peer dependency: react@18.3.1npmnpm WARN react-dom@17.0.2 requires a peer of react@17.0.2 but none is installed.npm 6npm ERR! npm ci can only install packages when your package.json and package-lock.json or npm-shrinkwrap.json are in sync.npmnpm ERR! The `npm ci` command can only install with an existing package-lock.json or npm-shrinkwrap.jsonnpm