首页·报错信息

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 个词。

相关报错