首頁·報錯訊息

npm · npm

報錯原文

npm ERR! The `npm ci` command can only install with an existing package-lock.json or npm-shrinkwrap.json

這是什麼意思

沒有 lock 檔,npm ci 根本不會執行,因為沒有任何東西告訴它該裝哪些版本。這發生在 package-lock.json 被 .gitignore 擋住、從未被提交過、或者你目前所在的目錄不是專案根的時候。npm install --package-lock-only 會只產生 lock 檔而不裝任何東西,把它提交上去,CI 就能跑了。千萬不要把 package-lock.json 放進 .gitignore:CI 兩次建置出同樣東西的保證,全靠這一個檔案。

怎麼修

npm install --package-lock-only
來自
npm
npm
20

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

怎麼讀報錯

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

常見問題

Q. “npm ERR! The `npm ci` command can only install with an existing package-lock.json or npm-shrinkwrap.json” 是什麼意思?

沒有 lock 檔,npm ci 根本不會執行,因為沒有任何東西告訴它該裝哪些版本。這發生在 package-lock.json 被 .gitignore 擋住、從未被提交過、或者你目前所在的目錄不是專案根的時候。npm install --package-lock-only 會只產生 lock 檔而不裝任何東西,把它提交上去,CI 就能跑了。千萬不要把 package-lock.json 放進 .gitignore:CI 兩次建置出同樣東西的保證,全靠這一個檔案。

Q. 怎麼修?

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

Q. 這是哪個工具報的?

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

相關報錯