package.json与package-lock.json

最新推荐文章于 2025-08-01 18:00:11 发布
原创 最新推荐文章于 2025-08-01 18:00:11 发布 · 928 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#npm #package.json #package-lock

本文探讨了在npm管理包时，为何会出现package-lock.json文件。当package.json中的包版本使用符号，导致不同时间安装可能导致版本差异，package-lock.json便用于锁定具体版本，确保团队成员安装的一致性。同时，文章指出cnpm不会更新package-lock.json，推荐使用npm i进行操作，并解释了为何package.json中未记录的包仍存在于package-lock.json中的情况。

任何事情都不是凭空发生，特别在是技术这件事情上；任何事情都是由最最基础发展而来的，只要追本溯源就能解决问题。

问题的产生

起因：项目走自动化构建不成功，说一个包连接github失败，但是在package.json里面根本没找到这个包，在代码里面也没看到（神奇脸.jpg）

猜测：可能是哪个包关联了吧。

结论：确实在package-lock.json里面发现了这个包，是项目中另一个包引入的问题，看到项目并没有用，就删除了，自动化是成功解决了。问题来了，为什么会出现这种情况，package.json里面没有，但是package-lock.json里面有。

package.json和package-lock.json

package.json就是我们在使用npm init就会产生的json文件，记录当前状态下实际安装的各个npm package的具体来源和版本号。

package-lock.json是在npm i或者npm update就会产生的json文件（npm 5.x.x或者更大就会有这个文件）

为什么会出现package-lock.json？

都知道，我们以前用package.json直接管理包，很方便，但是为什么会在后面版本出现一个package-lock.json文件，毕竟存在即合理。比如package.json里面安装包“express”：“^ 4.15.4”，这个意思是只要保证大版本就会被安装，这样的设计会出现同样的package.json但是不同的开发者安装的包不一样的情况，可能开发者A在今天安装是4.15.4，过1一个月开发者B加入，拉代码安装，这时候express更新了，变成了4.16.1，那么这时候开发者B安装的就是4.16.1。理论上是兼容的，但是可能会产生不同的结果，正因为这个不确定性，package-lock.json出现了，看lock英文就知道意思了。

package-lock.json锁定每个包的版本，让不同的开发者安装的包是同一个版本，所以建议把package-lock.json提交到项目远程，不要禁用它

最低0.47元/天 解锁文章
package.json 和 package-lock.json 的区别
慢慢
11-26 538
是 JavaScript 项目的基本配置文件，它包含了项目的元数据，包括项目名称、版本、描述、作者、许可证、依赖项、脚本命令等信息。它通常位于项目的根目录中，是 npm（Node 包管理器）使用的重要文件。是自动生成的文件，它锁定了项目中依赖包的确切版本和树状结构。这个文件确保团队成员、生产环境和持续集成环境中使用的一致性，使得项目在不同环境中能够以相同的方式运行。在 JavaScript 项目中，和是管理依赖关系和项目配置不可或缺的文件。用于定义项目的元信息和依赖，而则确保了依赖的版本一致性。
package.json 和package-lock.json
yrfjygb的博客
05-02 144
npm5 以前时不会有 package-lock.json 这个文件的。 npm5以后才加入了这个文件 当你安装包的时候，npm都会生成或者更新 package-lock.json这个文件 npm 5 以后的版本安装包不需要加 --save参数，它会自动保存依赖谢谢 当年安装包的时候，会自动创建或者时更新 package-lock.json这个文件 package-lock.json 这个文件会保存 node_modules 中所有包的信息(版本、下载地址) 这样的话重新npm install 的时候速度
package.json中的版本和package-lock.json的作用
01-07
引言 我们在搭建项目的时候，通过 npm 安装的依赖模块时，package.json文件中依赖的版本号前面会带符号 ^，有时候我们看别人的项目时也可能会看版本前带符号 ~ ，或者什么也不带，其中会有什么区别呢？而且当你的 npm 版本升级到 5.X.X 版本以上的时候，对应目录下还是自动生成一个 package-lock.json 文件，这个文件的作用又是什么呢。博主根据网上资料简单说明一下。 1.package.json 版本 dependencies: { react: ^16.8.0 react: ~16.8.0, react: 16.
webpack打包基础
Nelson_hehe的博客
09-16 638
本文简单介绍了使用webpack打包项目的过程，详情点击查看...
package.json 和 package-lock.json
qq_45830543的博客
01-27 239
npm5之前是不会有 package-lock.json这个文件的；在npm5以后才加入了这个文件。所以，当你安装包的时候，npm都会生成 或者 更新 package-lock.json 这个文件。 npm5 以后的版本安装包不需要加 --save 参数，它会自动保存依赖信息。 当你安装包的时候，会自动创建或者是更新package-lock.json这个文件。 package-lock.json 、package-lock.json这个文件会保存 node_modules 中所有包的信息(版本、.
package.json与package-lock.json的区别
jinfeng_yu的博客
04-11 195
在高版本的node.js和高版本的npm中使用npm install会产生package.json和package-lock,json。使用cnpm install只会生成package.json。package,json生成的是当前项目的支持版本情况，其中部分的插件版本会带有^，标识支持当前版本及更高的版本，使用npm install会自动生成当前大版本的最高版本，与原版本可能会存在版本不兼容的情况。package-lock.json,中显示的是当前版本的具体版本，一般需要上传这两个文件，以免出现，下载的
精选资源
将yarn.lock转换为package-lock.json，反之亦然-JavaScript开发
05-26
install npm install -g synp命令行用法yarn.lock => package-lock.json yarn＃确保node_modules文件夹目录并已更新synp --source-file /path/to/yarn.lock＃将创建/ path / to / package-lock.json package-lock....
精选资源
fix-package-lock：通过重新生成来修复package-lock.json
02-03
通过重新生成来修复package-lock.json 入门 先决条件 使用npm 5在Node v9上进行了测试。 正在安装 全局安装fix-package-lock将安装fix-package-lock命令： # Using npm npm install -g fix-package-lock # Using ...
package.json 和 package-lock.json 的关系
qhsr9177的博客
05-06 467
先安装一个测试包 初始化执行 npm init 会出现 package.json 的一个文件。 此处示例安装 express 包 （npm 5 以后的版本会默认加 --save，所以此处可以不加）npm install --save express 安装完后会发现多了一个 package-lock.json 的一个文件，且 package.json 文件里描述了 express 的版本信息 3.1 此时 package-lock.json 文件里是这样的内容 详解：我们在安装一个包时，如 ex
package.json和package-lock.json介绍
drawlessonsfrom的博客
11-29 7756
一、package.json 1、简介 package.json称之为包描述文件或者包说明文件，在项目中一般会创建package.json文件。 2、如何生成package.json文件 进入到相关项目目录的命令行终端，然后在终端输入： npm init 然后进行相关的配置即可。 如果想要快速生成package.json文件，可以在进入到相关的项目目录的命令行终端后输入： npm init -y 3、用途 描述相关的项目的项目名称，项目作者，所依赖的第三方包。 在项目中，最有用的是那个depende
package.json 与 package-lock.json 的区别
michiko98的博客
02-23 776
前言 现在前端越来越流行模块化开发，安装使用node和 npm 可以方便下载管理各个依赖模块。而描述模块信息的文件就是 package.json ，那么package-lock.json 又是什么，跟 package.json 有什么关系？本文将对该问题进行探索。 一、package.json { "name": "webpack-test", "version": "1.0.0", "description": "", "main": "index.js", "scri...
package.json和package-lock.json的区别
热门推荐
c2311156c的博客
05-15 1万+
package.json:主要用来定义项目中需要依赖的包package-lock.json：在 `npm install`时候生成一份文件，用以记录当前状态下实际安装的各个npm package的具体来源和版本号。'^' :放在版本号之前，表示向后兼容依赖，说白了就是在大版本号不变的情况下，下载最新版的包项目中引入的包版本号之前经常会加^号，每次在执行npm install之后，下载的包都会发生变...
一文了解 `package.json` 和 `package-lock.json`文件
最新发布
m0_74662483的博客
08-01 1557
package.json作为项目"身份证"，记录项目元数据，包括：项目信息、依赖声明（dependencies生产依赖和devDependencies开发依赖）、脚本命令（scripts）以及项目规范配置。其依赖版本使用特殊符号（^允许次版本更新，~允许补丁版本更新）定义版本范围。
关于package.json与package.lock.json的一些说明
etemal_bright的博客
08-19 373
package.json与package.lock.json区别 package.json是通过npm init创建时生成的 package-lock.json是在npm install的时候创建的 npm install的过程大致就是从package.json中读取所有的依赖信息，然后再与node_modules中已经安装的依赖进行对比，如果没有则通过package-lock.json获取相应版本号下载安装.如果已经存在则会通过package-lock.json检查更新。 "dependencies"
vue只有package-lock.json，没有package.json文件的时候
铁锤妹妹的博客
10-24 7721
一、前言 当博主把项目中的package.json与package-lock.json文件，还有node_moudle文件删除，然后执行npm init之后，发现竟然没有package.json，真是奇怪 最后百度发现： 当package.json与package-lock.json都不存在，执行"npm install"时，node会重新生成package-lock.json文件，然后把node_modules中的模块信息全部记入package-lock.json文件，但不会生成package.json文
package.json和package-lock.json的关系
qq_39183005的博客
06-10 669
今天学习到了一个小知识，就是终于明白了package.json和package-lock.json的关系 先说前面 ^和~的区别 ^ 开头意思是向后更新，如果当前使用版本是2.x.x,则在之后使用npm i或者yarn下载的时候会下载次要版本最新的 例如：当前使用2.3.6,但是最新的时候2.4.2,则会下载2.4.2版本 ~ 开头的意思是下载小版本最新的，当次要版本有新版本时不会下载 例如：当前使用2.3.6,但是最新的时候2.4.2，则会下载2.3.x的最新版本，不会下载2.4.2 package
nodejs package.json和package-lock.json文件的功能
王敬辉的博客
08-10 412
package-lock.json文件是为了让项目执行 npm install 时，下载pakcage.json中依赖库的固定版本，而不是范围允许内的更新版本，避免依赖包版本不同导致bug。 详解： package.json文件记录你项目中所需要的所有模块。 当你执行npm install的时候，node会先从package.json文件中读取所有dependencies信息，然后根据dependencies中的信息与node_modules中的模块进行对比，没有的直接下载，已有的检查更新（最新版本的nod
package.json和package-lock.json
03-17
### package.json 与 package-lock.json 的作用与差异 #### package.json 的作用 `package.json` 是 Node.js 项目中的核心配置文件之一，用于定义项目的元数据以及依赖项。它记录了项目所需的依赖包及其版本范围，开发者可以通过指定版本控制符来管理这些依赖的灵活性。例如，使用 `^`, `~` 或者具体版本号可以分别表示兼容大版本更新、小版本更新或者固定某个特定版本[^3]。 #### package-lock.json 的作用 为了应对因依赖版本变化而导致的潜在问题，Node.js 引入了 `package-lock.json` 文件。该文件的主要目的是锁定具体的依赖版本，从而确保无论在哪种环境下执行 `npm install`，所安装的依赖版本都保持一致。这有助于团队协作时减少由于不同成员使用不同版本依赖而引发的问题[^1]。 当一个新项目被创建并首次运行 `npm install` 安装依赖之后，会自动生成或更新 `package-lock.json` 文件。此文件不仅包含了顶层依赖的具体版本信息，还涵盖了所有子依赖（即间接依赖）的确切版本号和树形结构关系[^4]。 #### 版本一致性情况分析 关于何时 `package.json` 和 `package-lock.json` 中的版本号能够达到一致这一疑问，在理想状态下两者应该反映相同的语义化版本策略。然而实际上只有当最初设定 `package.json` 的时候就采用了精确匹配模式 (如 `"version": "1.0.0"` 而不是带有浮动空间的形式像 `"^1.0.0"` 或 `"~1.0.0"`) ，最终写入到 `package-lock.json` 的实际安装版本才会严格等于前者声明的目标区间内的某一点释放版次[^2]。 以下是基于上述描述的一个简单例子展示两者的关联： ```json // package.json { "name": "example", "dependencies": { "A": "^1.0.0", "B": "~2.0.0" } } ``` ```json // package-lock.json (部分) { "requires": true, "lockfileVersion": 1, "dependencies": { "A": { "version": "1.0.2", ... }, "B": { "version": "2.0.1", "dependencies": { "C": { "version": "3.0.0", ... } } } } } ``` 在这个案例里，“A”的最新稳定版可能是`1.0.2`满足`^1.0.0`条件；而对于“B”，其最近的小修正是`2.0.1`符合`~2.0.0`的要求，并且进一步锁定了"C"为确切的`3.0.0`版本。 #### 总结对比表 | 属性 | **Package.JSON** | **Package-Lock.JSON** | |---------------------|----------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------| | 主要功能 | 描述项目基本信息及所需依赖列表 | 锁定所有直接/间接依赖的具体版本 | | 更新频率 | 开发过程中手动修改 | 每次执行 npm install 自动生成或更新 | | 是否影响生产环境 | 不直接影响生产环境 | 影响生产环境下的依赖解析 | 通过以上解释可以看出，虽然这两个 JSON 文件紧密相连，但它们各自承担着不同的职责——一个是灵活指导性的清单文档，另一个则是严谨约束型的实际操作依据。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值