克隆Chrome扩展项目执行npm install后package-lock.json依赖被删如何解决

核心原因分类 #

• npm版本不兼容
  npm v6及更早版本生成的lockfile版本为v1，npm v7+默认使用v2版本lockfile。若仓库提交的package-lock.json由低版本npm生成，本地使用高版本npm执行npm install时会自动升级lockfile格式，过程中会删除不符合新格式规范的依赖条目。
  解决方法：确认仓库维护者使用的npm版本，通过nvm安装对应版本后重新执行安装操作。
• package.json与package-lock.json不同步
  若仓库中package.json的依赖版本范围与package-lock.json中锁定的版本存在冲突，npm安装时会以package.json的声明优先级为准，自动删除lock文件中不符合版本要求的条目。
  解决方法：执行npm ls校验依赖匹配情况，联系仓库维护者提交同步后的package.json与package-lock.json文件。
• 镜像源/缓存异常
  若本地配置的npm镜像源不存在package-lock.json中锁定的对应版本依赖，npm会自动忽略无法安装的依赖并删除对应lock条目，甚至尝试调整版本适配可用资源。
  解决方法：执行npm cache clean --force清理本地缓存，切换为仓库使用的官方/私有镜像源后重新安装。
• 可选依赖自动过滤
  部分依赖被标记为optionalDependencies，或限定了特定os、cpu架构运行环境，npm会自动跳过不符合本地环境的依赖并删除对应lock条目。若项目强制依赖此类可选依赖，就会出现运行模块缺失。
  解决方法：执行npm install --force强制安装全量依赖（含可选依赖）。
• lock文件本身损坏
  若仓库提交的package-lock.json存在Git合并冲突未修复、JSON语法错误等问题，npm解析文件失败时会忽略错误的lock内容，自动重新生成依赖树，导致原有锁定条目丢失。
  解决方法：检查package-lock.json是否存在<<<<<<<、=======等冲突标记，修复语法问题后重新执行安装。

此前操作无效的原因说明 #

• npm ci要求package.json与package-lock.json完全匹配，若二者本身存在冲突、lock文件损坏，npm ci会直接抛出异常，无法完成依赖安装。
• yarn默认读取自身的yarn.lock文件，不会识别npm的package-lock.json规则，直接执行yarn相关命令会忽略原有npm锁定的依赖版本，自然无法解决问题。

内容的提问来源于stack exchange，提问作者Saif U