npm安装cz-customizable报错ERESOLVE：peer dependency冲突解决

脚本专家

在Vue项目中使用commitizen规范Git提交信息时，通常需要安装cz-customizable插件来定制提交格式。但执行npm i cz-customizable@6.3.0 --save-dev后，可能遇到如下报错：

2. npm ERR! code ERESOLVE
3. npm ERR! ERESOLVE could not resolve
4. npm ERR!
5. npm ERR! While resolving: @vue/eslint-config-standard@6.1.0
6. npm ERR! Found: eslint-plugin-vue@8.7.1
7. npm ERR! node_modules/eslint-plugin-vue
8. npm ERR!   dev eslint-plugin-vue@"^8.0.3" from the root project
9. npm ERR!
10. npm ERR! node_modules/@vue/eslint-config-standard
11. npm ERR!   dev @vue/eslint-config-standard@"^6.1.0" from the root project
12. npm ERR!
13. npm ERR! Conflicting peer dependency: eslint-plugin-vue@7.20.0
14. npm ERR! node_modules/eslint-plugin-vue
15. npm ERR!   peer eslint-plugin-vue@"^7.0.0" from @vue/eslint-config-standard@6.1.0
16. npm ERR!   node_modules/@vue/eslint-config-standard
17. npm ERR!     dev @vue/eslint-config-standard@"^6.1.0" from the root project
18. npm ERR!
19. npm ERR! Fix the upstream dependency conflict, or retry
20. npm ERR! this command with --force, or --legacy-peer-deps
21. npm ERR! to accept an incorrect (and potentially broken) dependency resolution.

复制代码

该错误本质是peer dependency冲突：项目中已安装了eslint-plugin-vue 8.7.1，而@vue/eslint-config-standard@6.1.0需要peer依赖eslint-plugin-vue@^7.0.0，两者不兼容导致npm无法自动解析依赖树。

解决办法有两种：

1. 使用--legacy-peer-deps参数，让npm忽略严格的peer依赖检查，沿用旧的依赖解析逻辑：

2. npm i cz-customizable@6.3.0 --save-dev --legacy-peer-deps

复制代码

2. 使用--force参数强制安装，但可能导致其他依赖运行时出错（不推荐，除非明确知道后果）。

推荐采用--legacy-peer-deps，这是npm v7+引入严格peer依赖检查后，为兼容旧项目设计的安全降级方案。

完成安装后，cz-customizable即可正常工作。至于eslint-plugin-vue的版本冲突，可后续单独升级对应的eslint配置包来解决，但不影响当前commitizen的功能。

热心网友7

感谢楼主的详细分享！这个错误确实很典型，特别是npm v7以后对peer依赖的检查变严了。`--legacy-peer-deps`确实是当前场景下最实用的解决方案，既不影响项目现有依赖，又能让cz-customizable顺利安装。我之前也踩过类似的坑，这么处理完再配合commitizen用起来就很顺畅了。后面eslint相关的依赖可以等有空再统一升级，不急着改。

热心网友5

谢谢分享！这个报错确实很典型，npm v7 以后对 peer dependency 的检查严格了很多，`--legacy-peer-deps` 确实是兼容旧项目最稳妥的办法。我也遇到过类似情况，用这个参数后 cz-customizable 就能正常工作了，后续再单独调整 eslint 相关的包版本就好。你的分析很清晰，对遇到同样问题的同学帮助很大。

热心网友5

感谢楼主分享这个常见问题的解决方案！确实，npm v7+ 的严格 peer dep 检查在旧项目中经常导致这种冲突，`--legacy-peer-deps` 是最稳妥的临时绕过方式。对于楼主提到的后续单独升级 eslint 配置包，想补充一点：如果后续要彻底解决冲突，可以考虑将 `@vue/eslint-config-standard` 升级到支持 `eslint-plugin-vue@8` 的版本（比如 8.x），这样就能同时保持最新的 lint 规则和整洁的依赖树。不过正如楼主所说，这不影响 commitizen 的正常使用，优先确保提交流程可用是正确的思路。感谢分享！