开源项目 conventional-changelog
使用教程
项目介绍
conventional-changelog
是一个用于从项目的提交信息和元数据自动生成变更日志(CHANGELOG)和发布说明的工具。这个项目被广泛应用于前端和其他软件开发领域,帮助开发者自动化版本管理和文档生成过程。conventional-changelog
项目采用 monorepo 管理方式,包含多个 npm 包,其中最核心的包是 conventional-changelog
。
项目快速启动
安装
首先,你需要安装 conventional-changelog-cli
,这是一个命令行工具,用于生成 CHANGELOG。
npm install -g conventional-changelog-cli
生成 CHANGELOG
在你的项目根目录下运行以下命令来生成或更新 CHANGELOG 文件:
conventional-changelog -p angular -i CHANGELOG.md -s
这个命令会根据 Angular 提交规范解析你的提交历史,并生成或更新 CHANGELOG.md
文件。
应用案例和最佳实践
应用案例
一个典型的应用案例是在一个多人协作的前端项目中,开发者遵循 Angular 提交规范进行提交。每次发布新版本时,只需运行 conventional-changelog
命令,即可自动生成详细的 CHANGELOG,记录了每个版本的特性、修复和变更。
最佳实践
- 规范化提交信息:使用
commitizen
工具来帮助你规范化提交信息。 - 强制执行规范:通过
commitlint
和husky
来确保每次提交都符合规范。 - 自动化版本发布:结合 CI/CD 流程,自动执行版本发布和 CHANGELOG 生成。
典型生态项目
conventional-changelog
生态系统包含多个重要的模块和工具:
- commitizen:一个帮助你编写规范化提交信息的工具。
- commitlint:一个用于检查提交信息是否符合规范的工具。
- husky:一个 Git Hook 工具,可以在提交前强制执行规范检查。
- standard-version:一个自动化版本发布和 CHANGELOG 生成的工具。
这些工具共同构成了一个完整的自动化版本管理和文档生成流程,极大地提高了开发效率和文档质量。
通过以上内容,你可以快速了解并开始使用 conventional-changelog
项目,结合最佳实践和生态项目,实现高效的版本管理和文档自动化。