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相关的依赖可以等有空再统一升级，不急着改。