解决安装并配置cz-customizable插件遇到报错问题

安装并配置cz-customizable插件遇到报错

在实际项目开发中，很多时候我们需要借助 cz-customizable 来统一团队的 Git 提交信息规范。但当你执行安装命令时，可能并不会一帆风顺——比如下面这个典型的依赖冲突问题。

首先，使用 npm 安装指定版本：

npm i cz-customizable@6.3.0 --sa ve-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.

看到这个报错，背后的原因其实很清晰：@vue/eslint-config-standard@6.1.0 要求依赖 eslint-plugin-vue@^7.0.0，但当前项目已经安装了 eslint-plugin-vue@8.7.1，版本不匹配，导致 npm 的严格依赖解析机制（ERESOLVE）直接拒绝安装。

解决办法

既然知道了冲突来源，处理方式也很直接——在安装命令末尾加上 --force 或 --legacy-peer-deps，让 npm 忽略 peer 依赖的严格校验，强制安装目标包。

npm i cz-customizable@6.3.0 --sa ve-dev --legacy-peer-deps

这里推荐使用 --legacy-peer-deps，它采用的是 npm v6 及之前版本的依赖处理逻辑，通常比 --force 更安全——不会强制覆盖已安装的包，只是在解析冲突时降低标准。

总结

这类依赖冲突在 npm v7+ 中非常常见，尤其是当项目里同时存在需要不同版本 peer 依赖的包时。遇到后不必慌张，先分析报错信息中冲突的包名和版本，然后选择性地使用 --legacy-peer-deps 解决即可。当然，如果后续有时间，最好还是升级或统一项目中的相关依赖版本，从根本上避免冲突。