在前端开发中，使用 git 进行团队协作是非常常见的，而 commit message 是 git 协作中非常重要的一部分。cz-conventional-changelog-befe 是一个 npm 包，它提供了一套符合约定的 commit message 规范及其对应的 changelog 自动生成。
本篇文章将会介绍 cz-conventional-changelog-befe 的使用方法并提供样例代码。
为什么需要 cz-conventional-changelog-befe
在多人协作开发中，使用统一的 commit message 规范可以增加代码版本管理的可读性和可维护性。
cz-conventional-changelog-befe 遵循 Angular 团队的提交 message 格式约定，并且可以自动生成符合规范的 changelog，简化维护工作，提高团队开发效率。
起步
安装
安装 cz-conventional-changelog-befe：
npm install -g cz-conventional-changelog-befe
配置
添加配置文件 .czrc 到项目的根目录下：
{
"path": "cz-conventional-changelog-befe"
}确定好配置之后，它会自动读取此配置文件，并覆盖自己的默认行为。
使用
运行 git cz 命令来替代默认的 git commit 命令。
规范
cz-conventional-changelog-befe 使用了 Angular 团队的提交 message 格式，该格式约定包括以下几个部分：
[<type>][optional scope]: <description> [optional issue]
其中，各部分所代表的含义如下：
type（必填）：此次提交的类型，常见的包括以下几种：feat：新功能（feature）fix：修复 bugdocs：文档更新style：代码样式（不影响功能）refactor：代码重构（不涉及功能、 bug 修复）perf：性能优化test：测试相关chore：构建过程或辅助工具变动
scope（可选）：本次提交涉及到的模块或文件等description（必填）：本次提交的简要描述，首字母大写issue（可选）：本次提交出现了和哪个 issue 相关
例如：feat: add new feature 或 chore(config): update webpack config。
自动生成 changelog
在进行一次版本发布之前，需先生成 changelog 以便更好地向用户展示本次更新的内容。cz-conventional-changelog-befe 自动将 commit message 转换成格式化良好的 changelog。
安装
使用 npm 安装 cz-conventional-changelog-befe：
npm install -g conventional-changelog-cli
使用
运行 conventional-changelog 命令，将生成 changelog。默认情况下，它会将所有的提交记录转换为 markdown 格式的 changelog，并将其存储在 /CHANGELOG.md 文件中：
conventional-changelog -p angular -i CHANGELOG.md -s
其中：
-p：使用提交 message 格式规范，此处选择 Angular 团队的提交 message 格式规范。-i：指定 changelog 文件名。-s：从第一个 commit 记录生成 changelog，而不是从最新版本 tag 之后的记录开始。
结语
在本文中，我们介绍了什么是 cz-conventional-changelog-befe，以及在前端开发中的重要性。我们还提供了该包的安装、配置、使用说明，并提供了样例代码帮助大家更好地了解使用方法。
使用 cz-conventional-changelog-befe 可以让我们更好地管理代码的版本，增加代码的可读性和可维护性，并且方便用户查看版本更新信息。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600668e2d9381d61a35409ab