首頁·報錯訊息

npm · npm

報錯原文

npm ERR! ERESOLVE unable to resolve dependency tree

這是什麼意思

從 npm 7 起 peerDependencies 的版本範圍會被強制執行,這句話是說 npm 找不到一組能同時滿足所有範圍的版本。常見於你要裝的套件的 peer 範圍排除了你手上已有的 react 或 typescript 版本,尤其是剛做完一次大版本升級之後。讀輸出裡的 Found: 和 Could not resolve: 兩行,看清誰要求什麼,然後把兩者之一挪到相容的版本——這才是真正的修法。npm install --legacy-peer-deps 會完全無視 peer 範圍直接裝上,能讓你繼續往下走,但留下的是一棵各個套件從未認可的相依樹,版本不吻合帶來的執行時錯誤得你自己去查。

怎麼修

npm install --legacy-peer-deps
來自
npm
npm
20

npm 的原因寫在第一行 code XXXX 裡,而不是最後那六行 npm ERR!;如果失敗來自相依樹或原生編譯而不是你自己的程式碼,刪掉 node_modules 重新安裝就能解決一半。

怎麼讀報錯

  • 從第一行往下讀。越往下越是工具內部的事,起因通常寫在最上面。
  • 有檔名和行號就從那裡查——不是堆疊最上面那一格,而是最上面那條提到你自己寫的檔案的行。
  • 把報錯原文照樣去搜,但先去掉你自己的路徑和變數名,正是那些讓搜尋比對不上。
  • 同一種情況在不同版本裡措辭不同。結果不對頭,就把版本號一起加進查詢。
  • 貼上修法之前,先確認它會丟掉什麼。這裡面有些是不能收回的。

常見問題

Q. “npm ERR! ERESOLVE unable to resolve dependency tree” 是什麼意思?

從 npm 7 起 peerDependencies 的版本範圍會被強制執行,這句話是說 npm 找不到一組能同時滿足所有範圍的版本。常見於你要裝的套件的 peer 範圍排除了你手上已有的 react 或 typescript 版本,尤其是剛做完一次大版本升級之後。讀輸出裡的 Found: 和 Could not resolve: 兩行,看清誰要求什麼,然後把兩者之一挪到相容的版本——這才是真正的修法。npm install --legacy-peer-deps 會完全無視 peer 範圍直接裝上,能讓你繼續往下走,但留下的是一棵各個套件從未認可的相依樹,版本不吻合帶來的執行時錯誤得你自己去查。

Q. 怎麼修?

npm install --legacy-peer-deps —— 執行前先看上面的說明,確認這條命令會丟掉什麼。

Q. 這是哪個工具報的?

npm。它屬於npm,報錯原文有 8 個詞。

相關報錯