yarn 1 · 建置與型別
報錯原文
The engine "node" is incompatible with this module. Expected version ">=20"
這是什麼意思
你要安裝的套件在 package.json 的 engines 欄位裡宣告了它需要的 node 版本，而你目前用的版本落在這個範圍之外。後面跟著的 Expected 和 Got 把要求和你的版本並排列出，看這兩行就夠了——如果只有 CI 上報這個，那就是它的 node 版本和你機器上的不一樣。用 nvm install 20 && nvm use 20 升上去是正面的答案，並把同一個版本寫進 .nvmrc 和 CI 設定，下次才不會再岔開。yarn 的 --ignore-engines 能硬闖過去，但它只是抹掉警告，並不製造相容性：那個套件一旦用了更新的語法，就改成在執行時以語法錯誤炸掉。npm 把同樣的情形報成 EBADENGINE 警告，預設並不阻止安裝。
怎麼修
nvm install 20 && nvm use 20- 來自
- yarn 1
- 建置與型別
- 10
建置階段的錯誤是工具在執行之前就先拒絕了，所以它們出現的那一刻並不弄壞什麼——但它們問你兩個問題：你要把型別或路徑改成和真實結構一致，還是用一個 as any、一條抑制註解讓那一行過去？也正是在這裡，那些只在你自己機器上成立的事情——大小寫、副檔名、環境變數——第一次顯形。
怎麼讀報錯
- 從第一行往下讀。越往下越是工具內部的事，起因通常寫在最上面。
- 有檔名和行號就從那裡查——不是堆疊最上面那一格，而是最上面那條提到你自己寫的檔案的行。
- 把報錯原文照樣去搜，但先去掉你自己的路徑和變數名，正是那些讓搜尋比對不上。
- 同一種情況在不同版本裡措辭不同。結果不對頭，就把版本號一起加進查詢。
- 貼上修法之前，先確認它會丟掉什麼。這裡面有些是不能收回的。
常見問題
Q. “The engine "node" is incompatible with this module. Expected version ">=20"” 是什麼意思？
你要安裝的套件在 package.json 的 engines 欄位裡宣告了它需要的 node 版本，而你目前用的版本落在這個範圍之外。後面跟著的 Expected 和 Got 把要求和你的版本並排列出，看這兩行就夠了——如果只有 CI 上報這個，那就是它的 node 版本和你機器上的不一樣。用 nvm install 20 && nvm use 20 升上去是正面的答案，並把同一個版本寫進 .nvmrc 和 CI 設定，下次才不會再岔開。yarn 的 --ignore-engines 能硬闖過去，但它只是抹掉警告，並不製造相容性：那個套件一旦用了更新的語法，就改成在執行時以語法錯誤炸掉。npm 把同樣的情形報成 EBADENGINE 警告，預設並不阻止安裝。
Q. 怎麼修？
nvm install 20 && nvm use 20 —— 執行前先看上面的說明，確認這條命令會丟掉什麼。
Q. 這是哪個工具報的？
yarn 1。它屬於建置與型別，報錯原文有 11 個詞。