git-graph

一个命令行工具，以易于理解的方式可视化 Git 历史图表，支持不同的分支模型。

下方的图像展示了使用 GitFlow 分支模型的一个示例，用于比较 git-graph（最左边）与其他工具和 Git 客户端生成的图表。

选择 GitFlow 是因为它较为复杂，同时支持任何其他分支模型，包括用户自定义的。

您自己决定哪个图表最易于理解。😎

如果您想要一个 交互式 Git 终端应用程序，请查看基于 git-graph 的 git-igitt。

特性

• 直接在终端中查看结构化图表
• 预定义和自定义分支模型以及着色
• 不同样式，包括仅使用 ASCII 字符（即没有“特殊字符”）
• 自定义提交格式，例如使用 git log --format="..."

安装

预编译的二进制文件

1. 下载您平台的最新二进制文件
2. 解压缩到某个位置
3. 可选：将目录 git-graph 添加到您的 PATH 环境变量中

使用 cargo

如果您已经安装了 Rust，则可以使用 cargo 安装

cargo install git-graph

使用方法

有关详细信息，请参阅 手册.

对于基本使用，请在 Git 仓库文件夹中运行以下命令

git-graph

注意：git-graph 需要配置在 PATH 中，或者您需要使用 git-graph 的完整路径

C:/path/to/git-graph/git-graph

分支模型

使用特定模型运行 git-graph，例如 simple

git-graph --model simple

或者，永久设置当前仓库的模型

git-graph model simple

获取帮助

要获取所有选项的完整 CLI 帮助，请使用

git-graph -h
git-graph --help

有关 样式 和提交 格式化 的信息，请参阅 手册。

自定义分支模型

分支模型通过 APP_DATA/git-graph/models 目录中的文件进行配置。

• Windows: C:\Users\<user>\AppData\Roaming\git-graph
• Linux: ~/.config/git-graph
• OSX: ~/Library/Application Support/git-graph

可以在参数 --model 中使用 models 目录中的任何 .toml 文件的文件名，或通过子命令 model。例如，要使用在 my-model.toml 中定义的分支模型，使用

git-graph --model my-model

有关如何创建自己的分支模型的详细信息，请参阅手册，自定义分支模型 部分。

限制

• 合并提交的摘要（即消息的第一行）不应修改！git-graph 需要它们来分类合并分支。
• 仅支持主要远程仓库 origin。
• 目前不支持“八爪鱼合并”（即不超过2个父分支）
• 在 Windows PowerShell 上，将输出重定向到文件不正确（更改编码），因此您可能想使用默认的 Windows 控制台

贡献

请在 问题跟踪器 中报告任何问题和功能请求。

欢迎提交拉取请求。对于重大更改，请首先打开一个问题以讨论您想进行哪些更改。