[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 ```