gitx

用 Go 封装的 Git 命令行工具，提供更友好的交互体验 🚀

📦 安装

go install github.com/lhlyu/gitx@latest

📖 命令列表

命令	说明
gitx info	显示仓库信息（分支、远程地址、工作区状态等）
gitx branch	查看当前仓库的本地分支和远程跟踪分支（基于本地 refs，不主动联网）
gitx log [n]	查看当前仓库最近 N 条提交记录（默认 n=5，n 必须为正整数）
gitx tag	查看当前仓库的本地 tag，显示类型、时间、目标提交和提交标题（不主动联网）
gitx search <keyword> [--all] / gitx s <keyword> [--all]	快速查找关键字出现在哪些文件和行号里（依赖 rg，按字面量匹配；默认关键字至少 2 个字符、最多显示 20 条，--all 解除限制）
gitx list [depth]	列出指定深度的 Git 项目及其工作区状态（默认 depth=1）
gitx status [depth]	查看分支、领先/落后远程的提交数及工作区状态（默认 depth=0）
gitx pull [depth] / gitx p [depth]	拉取最新代码，可使用 --rebase、--ff-only、--prune（未传 depth 时，当前目录是仓库则只拉当前仓库，否则扫描直接子目录）
gitx undo [depth] -n	撤销工作区和暂存区的修改并显示结果（默认 depth=0；-n 仅预览）
gitx clean [depth] -n	清理仓库并显示清理结果，重置到最新提交状态 ⚠️（默认 depth=0；-n 仅预览）
gitx reset <steps> -n	将当前仓库硬重置到前 N 个提交，即执行 git reset --hard HEAD~N ⚠️（-n 仅预览）
gitx upgrade / gitx up	执行 go install github.com/lhlyu/gitx@latest 更新 gitx

多仓库操作（list/status/pull/clean/undo 在 depth ≥ 1 时）会按 CPU 核数并发执行， 执行期间在终端显示进度（[3/20]），重定向或管道时自动静默。 status 的领先/落后基于上次 fetch 的远程信息，不会主动联网。 扫描到的嵌套仓库以「相对扫描根目录的路径」显示（如 nest/c），顶层仓库则显示目录名。 批量扫描默认跳过隐藏目录、node_modules、vendor、vender 和 archive。

🛠️ 开发

项目结构

gitx/
├── cmd/              # 命令定义和注册
│   ├── root.go
│   ├── info.go
│   ├── branch.go
│   ├── log.go
│   ├── tag.go
│   ├── search.go
│   ├── list.go
│   ├── pull.go
│   ├── undo.go
│   ├── clean.go
│   ├── reset.go
│   └── upgrade.go
├── internal/         # 内部实现
│   ├── git/         # Git 客户端封装
│   ├── repo/        # 仓库扫描、并发执行与状态解析（公共）
│   ├── term/        # 终端显示宽度与列对齐工具（处理中英文混排）
│   ├── info/        # info 命令实现
│   ├── branch/      # branch 命令实现
│   ├── log/         # log 命令实现
│   ├── tag/         # tag 命令实现
│   ├── search/      # search 命令实现
│   ├── list/        # list 命令实现
│   ├── status/      # status 命令实现
│   ├── pull/        # pull 命令实现
│   ├── undo/        # undo 命令实现
│   ├── clean/       # clean 命令实现
│   └── reset/       # reset 命令实现
└── main.go          # 程序入口

添加新功能

遵循 feature 划分原则：

1. 在 cmd/ 目录下创建命令定义文件
2. 在 internal/{feature}/ 目录下创建具体实现
3. 使用 run.go 作为 feature 的入口