補上 Node、Angular、TypeScript 相容檢查,避免以 force 跳過真正的版本衝突。
適用:原筆記的Angular CLI/NgModule專案;新範例以Angular 20的standalone元件說明。建立專案前按官方版本表選Node與TypeScript,不能把舊專案直接套最新CLI。
先保留錯誤與環境
node --version
npm --version
npx ng version
npm ls @angular/core @angular/cli typescript
npm explain typescript在專案目錄執行,讀ERESOLVE中哪個套件要求哪個版本。Angular各核心套件通常需相容major,TypeScript也有版本上限;單純安裝最新TS可能讓compiler失敗。
處理順序
先核對package.json與官方相容表,選可相容的套件版本或按ng update路線升級。lockfile與package.json一致時用npm ci;npm install更新依賴圖,可能改lockfile。不要為了「乾淨」一開始就刪lockfile,否則難以追查差異。
--legacy-peer-deps忽略peer contract,--force容許多種衝突,不應作長期預設。若暫時為診斷使用,記錄原因並重新建立相容依賴圖後移除。
其他錯誤
EACCES檢查套件目錄許可權,不用sudo全域性install修復一切;ECONNRESET/TLS錯誤查proxy、registry與CA,不關strict-ssl。npm cache verify檢查快取,只有證據指向快取損壞才清理。
確認修正以npm ci、專案build及測試為準,不只install成功。網路服務/private registry錯誤要留去識別化日誌與HTTP狀態,token不貼公開。
冒險者留言
comments powered by Disqus