昨天帮同事修一个前端项目，npm install 后页面直接白屏，控制台报错：Uncaught TypeError: Object.assign is not a function。查了半天才发现，是 lodash 4.17.21 和某个 UI 组件里偷偷带的 lodash 3.10.1 在打架——这就是典型的依赖版本冲突。
啥叫依赖版本冲突？
简单说，就是项目里两个（或多个）模块，各自要求不同版本的同一个包。比如 A 模块说“我只认得 React 17”，B 模块偏要拉 React 18 进来，Node_modules 里没法同时塞俩“React”，最后运行时就容易翻车：方法没了、API 变了、甚至直接报错退出。
怎么一眼看出有冲突？
装完依赖后别急着跑，先敲这句：
npm ls react它会把项目里所有层级的 react 版本全列出来。如果看到类似这样的输出：
├─┬ antd@5.12.0
└── react@18.2.0
└── react@17.0.2说明项目根目录用的是 17，但 antd 内部又带了个 18 ——冲突苗头已经冒出来了。
常见解法，按顺序试试
① 优先用 npm override（推荐，适合 npm v8.3+）
在 package.json 里加个 overrides 字段，强制统一版本：
"overrides": {
"react": "18.2.0",
"react-dom": "18.2.0"
}保存后删掉 node_modules 和 package-lock.json，再 npm install，冲突基本就压平了。
② 降级或升级主依赖
比如你用的 axios 旧版只支持 Node.js 14，但项目已升到 20，那就别硬扛，直接：
npm install axios@latest或者查文档，换用兼容新版的替代库（像 ky 就更轻更现代）。
③ 用 resolutions（yarn 专属，或 npm 配 plugin）
yarn 用户可以在 package.json 加：
"resolutions": {
"**/lodash": "4.17.21"
}意思是：不管哪层引用 lodash，全给我锁死成 4.17.21。
预防比抢救更重要
平时写 package.json 别图省事全写 ^1.2.3，关键基础包建议写死小版本，比如 "react": "18.2.0"；CI 流水线里加一行 npm ls --depth=0，一有新冲突立刻报警；团队内部约定好基础依赖清单，避免各写各的。
依赖冲突不是玄学，它就像水管接头没拧紧——不漏则已，一漏就是满屋子水。多看一眼 npm ls，少熬一次夜。