痛点

在Git项目中，代码的频繁迭代会使得追踪项目文件结构变化的过程异常艰难，尤其是历史 commit 中存在、当前最新版本中已经不存在的文件/文件夹。

为了解决这个问题，Git Commit Tree Browser 提供了一个高效的解决方案。

简介

Git Commit Tree Browser 是基于Bash的脚本工具，通过为每个 commit 生成文件目录树，并配备交互式的浏览界面，可视化展示 Git 仓库各个 commit 状态下的文件树结构。

效果

功能特点

  • 为指定 Git 仓库中每个 commit 生成文件目录树文件
  • 提供终端交互界面，通过左右箭头键切换查看不同 commit 的文件目录树状态；按回车后激活跳转到指定 commit 模式，输入 commit ID（加文件扩展名 .txt）完成跳转

使用方法

前置条件

  1. 工具使用 Bash 脚本实现，需可执行 Bash 脚本的终端环境（Windows 操作系统可在 Git Bash 中使用）
  2. 工具依赖 tree 命令生成文件树结构，如终端中无法使用需提前安装（Windows 用户可以在 Git Bash 中安装 Tree for Windows）

执行 prepare.sh 脚本

执行 prepare.sh 脚本，传入 Git 仓库的路径作为参数：

1
2
3
$ git clone https://github.com/AlphaHinex/git-commit-tree-browser
$ cd git-commit-tree-browser
$ ./prepare.sh /path/to/your/git/repo

脚本将遍历指定 Git 仓库的所有 commit，并为每个 commit 在当前路径生成文件目录树文本文件 <commit_id>.txt。

当前生成目录树使用的命令是 tree -N -d -L 3，即只显示文件夹，最多显示三级路径。可根据实际需要进行调整。

执行 browser.sh 脚本

执行 browser.sh 脚本，开始按 commit 从老到新的顺序进行文件目录树浏览：

1
$ ./browser.sh

终端中将显示第一个commit的文件目录树，如：

1
2
3
4
5
6
7
8
9
10
11
12
13
File: 20df792.txt
.
|-- bronze
|   |-- gradle
|   |   `-- wrapper
|   `-- src
|       |-- main
|       `-- test
`-- git-commit-tree-browser

7 directories
20df792
Press left/right arrow to navigate, or Enter to jump to a file:

可以使用以下方式导航：

  • 使用左右箭头键在不同的 commit 之间切换
  • 按 Enter 键，然后输入 <commit_id>.txt 文件名，直接跳转到特定的commit

小工具会继续丰富功能，请期待~~~