package-lock.json

关于 package-lock.json,你需要知道的一些事情

  • 若是你使用的npm 5.0.0及以上的版本,package-lock.json会默认自动生成。
  • 你应该使用package-lock.json来确保一致的安装和兼容的依赖关系。
  • 你应该将package-lock.json提交到源代码仓库

npm 5.0.0 以后的版本变化

参考: npm install 生成的package-lock.json是什么文件?有什么用?open in new window

npm 5.x发布以来到现在的npm 5.6.0lock的作用变更过好多次。从npm 3.x更新到了npm 5,但是发现执行npm i时的现象跟网络上的科普文不太一致。

有提到不管怎么修改package.json文件,重复执行npm inpm都会根据package-lock.json文件描述的版本信息进行下载。 也有提到重复npm i时,npm会不顾package-lock.json的信息, 根据package.json中的包 Semantic versioning 版本信息下载更新模块(package-lock.json貌似没啥用了)。

查阅资料得知,自npm 5.0版本发布以来,npm i的规则发生了三次变化。

  1. npm 5.0.x版本,不管package.json怎么变,npm i时都会根据package-lock.json文件下载。 package-lock.json file not updated after package.json file is changed · Issue #16866 · npm/npmopen in new window这个issue控诉了这个问题,明明手动改了package.json,为啥不给我升级包!然后就导致了npm 5.1.0的问题。
  2. npm 5.1.0版本后npm i会无视package-lock.json文件,而是去下载最新的包。然后就有人提了这个issuewhy is package-lock being ignored? · Issue #17979 · npm/npmopen in new window控诉这个问题,最后演变成npm 5.4.2版本后的规则。
  3. npm 5.4.2版本后,why is package-lock being ignored? · Issue #17979 · npm/npmopen in new window。大致意思是,如果改了package.json,且package.jsonpackage-lock.json文件不同,那么执行npm inpm会根据package.json中的版本号以及语义含义去下载最新的包,并更新至package-lock.json。如果两者是同一状态,那么执行npm i都会根据package-lock.json下载,不会理会package.json实际包的版本是否有新。