[TOC] > [home](https://git-cliff.org/docs/installation/winget) ## 概述 `git-cliff` 是一个用于生成 Git 提交日志的工具，它帮助开发者快速生成易于阅读的变更日志。该工具支持多种格式，能够自动提取和格式化 Git 提交信息，便于项目管理和版本控制。 ## 安装 ### rust /cargo ``` cargo install git-cliff ``` ### window ``` winget install git-cliff ``` ### Linux ``` > export version="1.0.0" > wget "https://github.com/orhun/git-cliff/releases/download/v${version}/git-cliff-${version}-x86_64-unknown-linux-gnu.tar.gz" > tar -xvzf git-cliff-*.tar.gz > cd "git-cliff-${version}" > ./git-cliff ``` ### npm ``` npm install git-cliff --save-dev ``` ## 语法 ``` // 为标记“1.0.0”生成更改日志，而不创建标记本身 git cliff --tag 1.0.0 // 从开始有标签的 记录开始生成 git cliff --latest // 排序,旧的再前 git cliff --sort oldest // 新的 在前 git cliff --sort newest // 指定输出 git cliff --output [CHANGELOG.md] ``` **跳过某些 commit** 创建 .cliffignore ``` 4f88dda8c746173ea59f920b7579b7f6c74bd6c8 10c3194381f2cc4f93eb97404369568882ed8677 ``` 再执行 `git cliff`,就会默认去除 ## 示例 ### 快速入门 ``` > git cliff --init > git cliff > CAHNGELOG ```