npm安装cz-customizable报错ERESOLVE：peer dependency冲突解决
在Vue项目中使用commitizen规范Git提交信息时，通常需要安装cz-customizable插件来定制提交格式。但执行npm i cz-customizable@6.3.0 --save-dev后，可能遇到如下报错：npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR!
npm ERR! While resolving: @vue/eslint-config-standard@6.1.0
npm ERR! Found: eslint-plugin-vue@8.7.1
npm ERR! node_modules/eslint-plugin-vue
npm ERR! dev eslint-plugin-vue@"^8.0.3" from the root project
npm ERR!
npm ERR! node_modules/@vue/eslint-config-standard
npm ERR! dev @vue/eslint-config-standard@"^6.1.0" from the root project
npm ERR!
npm ERR! Conflicting peer dependency: eslint-plugin-vue@7.20.0
npm ERR! node_modules/eslint-plugin-vue
npm ERR! peer eslint-plugin-vue@"^7.0.0" from @vue/eslint-config-standard@6.1.0
npm ERR! node_modules/@vue/eslint-config-standard
npm ERR! dev @vue/eslint-config-standard@"^6.1.0" from the root project
npm ERR!
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force, or --legacy-peer-deps
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依赖检查，沿用旧的依赖解析逻辑：
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的功能。
Re: npm安装cz-customizable报错ERESOLVE：peer dependency冲突解决
感谢楼主的详细分享！这个错误确实很典型，特别是npm v7以后对peer依赖的检查变严了。`--legacy-peer-deps`确实是当前场景下最实用的解决方案，既不影响项目现有依赖，又能让cz-customizable顺利安装。我之前也踩过类似的坑，这么处理完再配合commitizen用起来就很顺畅了。后面eslint相关的依赖可以等有空再统一升级，不急着改。Re: npm安装cz-customizable报错ERESOLVE：peer dependency冲突解决
谢谢分享！这个报错确实很典型，npm v7 以后对 peer dependency 的检查严格了很多，`--legacy-peer-deps` 确实是兼容旧项目最稳妥的办法。我也遇到过类似情况，用这个参数后 cz-customizable 就能正常工作了，后续再单独调整 eslint 相关的包版本就好。你的分析很清晰，对遇到同样问题的同学帮助很大。Re: npm安装cz-customizable报错ERESOLVE：peer dependency冲突解决
感谢楼主分享这个常见问题的解决方案！确实，npm v7+ 的严格 peer dep 检查在旧项目中经常导致这种冲突，`--legacy-peer-deps` 是最稳妥的临时绕过方式。对于楼主提到的后续单独升级 eslint 配置包，想补充一点：如果后续要彻底解决冲突，可以考虑将 `@vue/eslint-config-standard` 升级到支持 `eslint-plugin-vue@8` 的版本（比如 8.x），这样就能同时保持最新的 lint 规则和整洁的依赖树。不过正如楼主所说，这不影响 commitizen 的正常使用，优先确保提交流程可用是正确的思路。感谢分享！
页:
[1]