【git】subtree拆分大的git库到多个独立git库

【git】subtree拆分大的git库到多个独立git库

一、拆分一个子目录为独立仓库

bash 复制代码
# 这就是那个大仓库 big-project
git clone git@github.com:tom/big-project.git
cd big-project

# 把所有 `eiyo` 目录下的相关提交整理为一个新的分支 eiyo_code
git subtree split -P eiyo -b eiyo_code

# 另建一个新目录并初始化为 git 仓库
mkdir ../eiyo_code
cd ../eiyo_code
git init

# 拉取旧仓库的 eiyo 分支到当前的 master 分支
git pull ../big-project eiyo_code

二、推送给新的远端仓库

bash 复制代码
# GitHub 新建一个空仓库(无README.md  .gitignore LICENSE )  git://github.com:tom/eiyo_code.git

git remote add origin git://github.com:tom/eiyo_code.git
git push origin -u master # -u 或 --set-upstream 选项用于将本地分支与远程分支关联起来

三、清除一个子目录下所有内容和记录

这个还是要用万能的 filter-branch:

bash 复制代码
# 还是那个大仓库 big-project
git clone git@github.com:tom/big-project.git
cd big-project

# 清理 `master` 分支上所有跟 `eiyo` 目录有关的痕迹
git filter-branch --index-filter "git rm -rf --cached --ignore-unmatch eiyo" --prune-empty master

## 推送清理之后的数据
git push --force

至此,就将一部分eiyo 代码 分割成一个单独的仓库 并且保留日志。接下来科普一下 git subtree


四、git subtree 合并

git subtree:合并策略,通过git subtree命令能将依赖库某分支合并到主项目的分支中,在开发过程中,只需对主项目分支进行统一管理。

创建合并subtree add命令

命令如下:

bash 复制代码
git subtree add -P <prefix> <commit>
git subtree add -P <prefix> <repository> <ref>

两步走

(一)先fetch库再subtree add合并
  1. 先将依赖库fetch到本地仓库中
bash 复制代码
// 创建lib的远程版本库: 
git init --bare lib-rep
#-f:远端库添加后立即执行fetch操作
git remote add -f librepo ../lib-rep
  1. 通过git subtree命令将依赖库合并到主项目中
bash 复制代码
git subtree add -P lib librepo master  
(二)squash合并法

--squash: 适用于add/pull/merge子命令。先合并引用库的更新记录,将合并结果并到主项目中。

bash 复制代码
git subtree add --prefix=themes/jacman --squash https://it-boyer@github.com/it-boyer/jacman.git master   

五、subtree其他命令

git subtree支持创建(add)之外,还支持更新(pull),推送(push),合并(merge),抽离(split)以下命令:

bash 复制代码
git subtree pull -P <prefix> <repository> <ref>
git subtree push -P <prefix> <repository> <ref>
git subtree merge -P <prefix> <commit>
git subtree split -P <prefix> [OPTIONS] [<commit>]

(一)从子树库中拉取最新代码:

bash 复制代码
git subtree pull --prefix=themes/jacman --squash https://it-boyer@github.com/it-boyer/jacman.git master

(二)将自己的代码发布到子树库:

bash 复制代码
git subtree push --prefix=themes/jacman --squash https://it-boyer@github.com/it-boyer/jacman.git master

(三)相关参数:

bash 复制代码
q | --quiet
-d | --debug
-P <prefix> | --prefix=<prefix>      引用库对应的本地目录
-m <message> | --message=<message>   适用于add/pull/merge子命令。设置产生的合并提交的说明文本
--squash                             适用于add/pull/merge子命令。先合并引用库的更新记录,将合并结果并到主项目中。
使用此选项时,subtree add/pull会产生两个提交版本:一个是子项目的历史记录,一个是Merge操作。好处是可以让主项目历史记录很规整,缺点是子项目更新时常常需要解决冲突。一个更好的解决方案是:单独建一个分支进行--no-squash的subtree更新,然后再--squash合并到主分支。每次在此分支做操作前都需要先把主分支合并进来。参考:http://www.fwolf.com/blog/post/246

(四)split子命令选项:

bash 复制代码
--annotate=<annotation>              创建合成历史时有可能形成内容不同但提交信息完全相同的提交版本,使用这个选项在每个提交消息前加上此前缀用来区分。
-b <branch> | --branch=<branch>      创建合成的提交历史时,创建此参数指定的新分支包含生成的合成历史。<branch>必须是还不存在的。
--onto=<onto>
--rejoin
--ignore-joins

(五)使用sourcetree管理

  1. 配置 subtree 菜单:Repository -> Add/Link subtree...(添加/链接子树...) 在左边栏的SUBTREES(子树)中显示:

  2. 拉取依赖库的最新代码 在右边栏右击已存在的subtree,并选择 pull subtree...菜单项: 第二步的功能代码如下:

bash 复制代码
git -c subtree pull -P themes/.jacman --squash https://it-boyer@github.com/it-boyer/jacman.git master
相关推荐
阿里嘎多学长13 小时前
2026-07-10 GitHub 热点项目精选
开发语言·程序员·github·代码托管
山海云端有限公司15 小时前
深入理解网页元数据提取API:参数详解与最佳实践
api·开发工具·seo·网页元数据·技术栈识别
莫成15 小时前
git相关命令查阅
git
ljh57464911919 小时前
git stash 和 git stash apply
git
今夕资源网20 小时前
AI声音克隆软件 CosyVoice今夕一键整合包解压即用 阿里巴巴通义实验室开源 github斩获22K星标
人工智能·github·多国语言·声音克隆·零样本语音克隆·感情·ai语音克隆
胡萝卜术1 天前
从聊天模型到本地执行助手:Remote MCP 多工具 Agent 实战
面试·架构·github
慕容引刀1 天前
告别Commit信息纠结:使用Git AI Commit插件实现规范化提交
人工智能·git·github·visual studio code·visual studio
GoGeekBaird1 天前
我开源了 BeeWeave,给 AI Agent 搭一个越用越懂你的知识创作台
后端·github
fthux1 天前
GitZip Pro 源码解析:一个 GitHub 文件/文件夹下载扩展是如何工作的(一)整体架构与扩展入口
人工智能·ai·开源·github·open source
第一程序员1 天前
Rust Agent 子进程执行:Command 之前,先定义输入和超时
python·rust·github