「一种以树状结构管理本地 git 仓库的思路」

F 2, 2024·

本文的内容高度受到这篇文章的启发

现状

作为软件开发人员，git clone可以说是最常用的命令之一，随着本地 git 仓库的越来越多，不知道大家是如果对其进行管理的。可能大部分人只是简单创建了一个名称类似Developer或者Projects的文件夹，然后把所有仓库都放在里面。

随着仓库越来越多，这种原始的方法导致的问题有：

难以快速找到一个 git 仓库
可能会遇到重名的问题。比如很多组织下都会一个 docs 仓库（ vuejs/docs;unplugin/docs ）。

什么是树状结构

一句话概括，就是将一个 git 仓库以<远程地址>/<所有者>/<仓库名>的文件夹结构进行存储。

比如在 clone 这个仓库时 https://github.com/vuejs/docs

通过输入以下命令，就能实现树状结构管理

git clone https://github.com/vuejs/docs.git ~/Projects/github/vuejs/docs

但这种方式带来的问题是每次 clone 时都会有心智负担，需要手动补全路径。

介绍 Gitrees

Gitrees是一个命令行工具，通过简单的命令就能实现以上效果

demo

基本用法

安装

npm install -g gitrees

初始化配置文件

gt init

这个命令会自动在用户目录生成一个 json 配置文件:

{
  // 远程仓库地址的别名
  "alias": {
    "github.com": "github",
    "gitlab.com": "gitlab",
    "you-company.com": "company"
  },
  // 存储所有本地 git 仓库的根目录
  "root": "/Users/hostname/Projects"
}

clone 仓库

gt clone https://github.com/vuejs/core.git

会自动转化为：

git clone https://github.com/vuejs/core.git /Users/hostname/Projects/github/vuejs/core

最佳实践

经过个人一段时间的实践体验下来，这种树状结构带来的问题是仓库的层级太深，有时在查找一个仓库时需要 cd 好多次，通过搭配 zsh 的插件z可以快速定位到一个仓库，能在一定程度上解决这个问题。

Gitrees 开源仓库：https://github.com/yuyinws/gitrees