原文地址:https://wyiyi.github.io/amber/2024/04/01/git-commit-tree/
痛点
在Git
项目中,代码的频繁迭代会使得追踪项目文件结构变化的过程异常艰难,尤其是历史 commit
中存在、当前最新版本中已经不存在的文件/文件夹。
为了解决这个问题,Git Commit Tree Browser
提供了一个高效的解决方案。
简介
Git Commit Tree Browser 是基于Bash
的脚本工具,通过为每个 commit
生成文件目录树,并配备交互式的浏览界面,可视化展示 Git
仓库各个 commit
状态下的文件树结构。
效果
功能特点
- 为指定
Git
仓库中每个commit
生成文件目录树文件 - 提供终端交互界面,通过左右箭头键切换查看不同
commit
的文件目录树状态;按回车后激活跳转到指定commit
模式,输入commit
ID(加文件扩展名.txt
)完成跳转
使用方法
前置条件
- 工具使用 Bash 脚本实现,需可执行 Bash 脚本的终端环境(
Windows
操作系统可在Git Bash
中使用) - 工具依赖
tree
命令生成文件树结构,如终端中无法使用需提前安装(Windows
用户可以在Git Bash
中安装 Tree for Windows)
执行 prepare.sh 脚本
执行 prepare.sh
脚本,传入 Git
仓库的路径作为参数:
$ 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
从老到新的顺序进行文件目录树浏览:
$ ./browser.sh
终端中将显示第一个commit
的文件目录树,如:
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
小工具会继续丰富功能,请期待~