commitlint 使用教程

项目介绍

commitlint 是一个用于校验 git commit 消息是否符合约定式提交规范的工具。它帮助团队维护一致的提交消息格式，从而提高项目的可维护性和协作效率。commitlint 支持通过 npm 安装的配置，使得共享提交规范变得简单。

项目快速启动

安装 commitlint

首先，你需要安装 commitlint 及其配置包：

npm install --save-dev @commitlint/config-conventional @commitlint/cli

配置 commitlint

在项目根目录下创建一个 commitlint.config.js 文件，并添加以下内容：

module.exports = {
  extends: ['@commitlint/config-conventional']
};

安装并配置 husky

为了在每次提交时自动运行 commitlint，你需要安装并配置 husky：

npm install --save-dev husky
npx husky install
npx husky add .husky/commit-msg 'npx --no-install commitlint --edit "$1"'

测试 commitlint

现在，你可以尝试提交一个符合规范的 commit 消息：

git commit -m "feat: 增加 xxx 功能"

如果提交消息不符合规范，commitlint 将会报错并阻止提交。

应用案例和最佳实践

应用案例

假设你在一个团队中工作，团队成员提交的 commit 消息格式不一致，导致难以追踪和管理代码变更。通过使用 commitlint，你可以强制团队成员遵循统一的提交规范，从而提高代码库的可维护性。

最佳实践

1. 自定义规则：根据团队的具体需求，可以自定义 commitlint 规则，以适应特定的提交规范。
2. 集成 CI：将 commitlint 集成到持续集成（CI）流程中，确保每次提交都符合规范。
3. 文档和培训：为团队成员提供 commitlint 的使用文档和培训，确保每个人都了解并遵循提交规范。

典型生态项目

commitizen

commitizen 是一个辅助工具，可以帮助你编写符合规范的 commit 消息。它可以与 commitlint 配合使用，提供交互式的提交消息编写界面。

conventional-changelog

conventional-changelog 是一个生成符合约定式提交规范的 changelog 文件的工具。它可以根据提交历史自动生成详细的变更日志，方便用户了解项目的发展历程。

通过结合这些生态项目，你可以构建一个完整的提交规范和文档生成流程，进一步提升项目的质量和可维护性。