返回知识库

工程与栈 · 开发基础

依赖锁文件Lockfile

比较依赖范围、锁定版本与安装收据,再用不一致失败检验冻结安装的边界。

同一依赖范围,两台电脑装出什么版本?

先分别安装,再共享锁文件重装;最后修改清单,检查冻结安装如何阻止不一致。

第 0 步:先打开 package.json 与 package-lock.json;终端运行 npm ci 可做冻结安装。以下 signup-ui 与版本注册表均为虚构,无真实安装。

依赖声明

signup-ui: ^1.2.0

这里是允许范围,不是安装收据。

package-lock.json

(无共享锁文件)

两台机器分别按当时注册表解析

电脑 A · 较早注册表

安装收据

未安装

还没有成功安装结果

电脑 B · 较晚注册表

安装收据

未安装

还没有成功安装结果

先分别安装,对照两次安装实际解析到的版本。

知识点:范围与安装结果分工不同

package.json 表达允许范围;package-lock.json 记录解析出的精确版本、依赖树与获取信息。范围没有变,新发布的兼容版本也可能让无锁安装得到不同结果。

npm ci 要求已有锁文件,并在它与清单不一致时退出,不能静默替你改锁。更新依赖时用相应安装/更新流程生成锁,评审后将清单和锁一起提交。

什么时候用、怎么用

  1. 团队和 CI 需要重现安装时,选择一种包管理器并提交它的锁文件。
  2. 克隆项目后按 README 使用匹配的运行时和冻结安装命令,如 npm ci。
  3. 依赖更新要看清单与锁的差异、跑项目检查,确认后一起提交。

锁定依赖树不等于整个环境逐位一致:操作系统、CPU、Node 版本、安装脚本和可选依赖仍可能影响结果。

正反例:两人运行同一报名工具

正例:同一清单、同一锁、匹配环境下使用冻结安装,两张收据都是 1.2.3。

反例:只传 ^1.2.0 这个范围,不传锁;安装时间不同可得到 1.2.3 与 1.3.0,故障难以重现。

快速自测

CI 提示清单与锁文件不一致,应该怎样处理?

继续查证

术语的技术定义和行为以这些一手或权威资料为准。

下一步学