package-lock.json 冲突

一句话：多人协作开发时，package-lock.json文件在Git合并时产生冲突，通常是不同人在不同时间装了不同版本的依赖导致的。

它是什么

package-lock.json记录了项目依赖的精确版本树，团队多人开发、各自装包后提交，这个文件很容易产生Git合并冲突。处理不当可能导致依赖版本不一致，团队成员运行同样代码却出现不同结果。

适合干什么

• 团队协作开发中Git合并遇到package-lock.json冲突
• 想理解为什么这个文件总是冲突

不适合干什么

• 个人独立开发、没有多人协作场景（不太会遇到这个问题）

普通人怎么用

遇到冲突最简单稳妥的做法：不要手动编辑这个文件解决冲突，而是删掉冲突的package-lock.json，重新运行 npm install 让它自动生成一份新的，再提交。

进阶用户怎么用

团队建立规范：统一用同一个包管理器（不要一部分人用npm一部分人用yarn/pnpm，会导致lock文件格式不同）、装新依赖后及时提交、CI流程里用 npm ci 而不是 npm install 保证安装的严格一致性。

常见误区

• 以为可以像普通代码文件一样手动编辑解决冲突，这个文件结构复杂，手动改极易改出问题
• 以为package-lock.json不重要可以随便处理，实际它保证了团队所有人、以及生产环境安装的依赖版本完全一致，很重要

和相似工具的区别

• 和普通代码文件的Git冲突处理方式不同：普通代码冲突要理解两边改动分别保留，lock文件冲突建议直接重新生成，而不是手动合并

入门步骤

• 确认团队统一使用哪个包管理器
• 遇到冲突时删除该文件重新npm install生成
• 确认package.json里的依赖版本没有丢失后提交