git submodule

添加子模块

此时 会多出 .gitmodules 文件 ，记录子模块

DbConnector是工作目录中的一个子目录，但 Git 还是会将它视作一个子模块。当你不在那个目录中时，Git 并不会跟踪它的内容， 而是将它看作子模块仓库中的某个具体的提交

git diff –cached –submodule 查看子模块变动

克隆含有子模块的项目

当你在克隆这样的项目时，默认会包含该子模块目录，但其中还没有任何文件

你必须运行两个命令：git submodule init 用来初始化本地配置文件，而 git submodule update 则从该项目中抓取所有数据并检出父项目中列出的合适的提交。

如果给 git clone 命令传递 --recurse-submodules 选项，它就会自动初始化并更新仓库中的每一个子模块

你已经克隆了项目但忘记了 --recurse-submodules，那么可以运行 git submodule update --init 将 git submodule init 和 git submodule update 合并成一步。

如果还要初始化、抓取并检出任何嵌套的子模块， 请使用简明的 git submodule update --init --recursive。

在包含子模块的项目上工作

从子模块的远端拉取上游修改

如果想要在子模块中查看新工作，可以进入到子目录中运行 git fetch 与 git merge origin/master ，合并上游分支来更新本地代码。

git diff –submodule 查看新添加提交的列表

git submodule update –remote // 自动从远程抓取合并，但是默认合并的是master 分支

如果你想跟踪其他分支比如dev分支：

更新子模块后，运行 git status，Git 会显示子模块中有“新提交”， 然后再提交主git，把这次更新体检

git pull 命令会递归地抓取子模块的更改，如上面第一个命令的输出所示。 然而，它不会 更新 子模块

 git pull 命令添加 --recurse-submodules  自动化拉起合并所有子模块

在子模块上工作

说明： 子模块是没有本地分支的，修改时都是在游离的HEAD 上更改，下次运行 git submodule update 时就会丢失

为了方便的在本地修改子模块，需要做以下几步:

修改子模块

此时我们发下远程子模块也有一个更改，就要去合并远程分支

注意：1如果你忘记 --rebase 或 --merge，Git 会将子模块更新为服务器上的状态。并且会将项目重置为一个游离的 HEAD 状态。 如果真的发生了也不要紧，你只需回到目录中再次检出你的分支（即还包含着你的工作的分支）然后手动地合并或变基 origin/stable（或任何一个你想要的远程分支）就行了

2. 如果你没有提交子模块的改动，那么运行一个子模块更新也不会出现问题，此时 Git 会只抓取更改而并不会覆盖子模块目录中未保存的工作

3. 如果你做了一些与上游改动冲突的改动, 你可以进入子模块目录中然后就像平时那样修复冲突

发布子模块改动

说明： 主项目中提交并推送但并不推送子模块上的改动，其他尝试检出我们修改的人会遇到麻烦， 因为他们无法得到依赖的子模块改动。那些改动只存在于我们本地中。为了确保这不会发生，你可以让 Git 在推送到主项目前检查所有子模块是否已推送。 git push 命令接受可以设置为 “check” 或 “on-demand” 的 --recurse-submodules 参数。 如果任何提交的子模块改动没有推送那么 “check” 选项会直接使 push 操作失败。

git config push.recurseSubmodules check  //让它成为默认行为

on-demand，它会使Git 会进入到 子模块中，然后在推送主项目前，推送了子模块。 如果那个子模块因为某些原因推送失败，主项目也会推送失败

合并子模块改动

子模块的问题

从子目录切换到子模块

 假设项目内有一些文件在子目录中，你想要将其转换为一个子模块。 如果删除子目录然后运行 submodule add，Git 会朝你大喊：

你必须要先取消暂存 CryptoLibrary 目录。 然后才可以添加子模块：