如何把一个工程中的某个目录添加为git submodule

git 的 submodule 方式不会向仓库添加实际的的内容的，只会通过 .gitmodules 文件保留相应的子模块的哈希值。

由于你要真正要用的代码处于一个子目录中，我的方案是你先把这个子目录提取成一个单独的仓库（可以使用 git-subtree.sh

这个脚本），然后再添加这个仓库为 submodule（或者直接使用 git-subtree.sh

把实际的代码集成到你的项目，这样别人克隆就不需要更新 submodule 了）。这样做的缺点就是每当上游有更新，就需要对 submodule

的仓库做相应更新。

另外：git-subtree.sh 已经合并入 git 了，可能并不在 PATH 中，不能直接执行，不过应该在 git 的安装中的。

另一个思路：

建立 bundles 目录，添加原仓库为 submodule 到此，然后对需要的子目录做相对路径软链接，git 能够正确处理软链接。这可能是比较好的一个办法了，不需要额外维护同上游的同步。

有种情况我们经常会遇到：某个工作中的项目需要包含并使用另一个项目。 也许是第三方库，或者你独立开发的，用于多个父项目的库。 现在问题来了：你想要把它们当做两个独立的项目，同时又想在一个项目中使用另一个。这种情况就可以使用Git子模块。

clone地址: https://github.com/xxx/parent.git

clone地址: https://github.com/xxx/child.git

注: 创建仓库的时候勾选README.md,保证不是空仓库

在父目录下，执行 git submodule add https://github.com/xxx/child.git

这时运行 git status

会出现

此时执行

如果单纯的使用git clone命令，当你在克隆这样的项目时，默认会包含该子模块目录，但其中还没有任何文件。解决办法：

git submodule update --remote Git 默认会尝试更新 所有 子模块， 所以如果有很多子模块的话，你可以传递想要更新的子模块的名字。例: git submodule update --remote submoduleName

此命令默认会假定你想要更新并检出子模块仓库的 master 分支，不过你也可以设置为想要的其他分支，那么既可以在 .gitmodules 文件中设置 （这样其他人也可以跟踪它），也可以只在本地的 .git/config 文件中设置。

git config -f .gitmodules submodule.submoduleName.branch develop

如果你想自动化此过程，那么可以为 git pull 命令添加 --recurse-submodules 选项（从 Git 2.14 开始）。

你想让 Git 总是以 --recurse-submodules 拉取，可以将配置选项 submodule.recurse 设置为 true （从 Git 2.15 开始可用于 git pull）。此选项会让 Git 为所有支持 --recurse-submodules 的命令使用该选项（除 clone 以外）。

步骤如下：

rm -rf 子模块目录 删除子模块目录及源码

vi .gitmodules 删除项目目录下.gitmodules文件中子模块相关条目

vi .git/config 删除配置项中子模块相关条目

rm .git/module/* 删除模块下的子模块目录，每个子模块对应一个目录，注意只删除对应的子模块目录即可

执行完成后，再执行添加子模块命令即可，如果仍然报错，执行如下：

git rm -f --cached 子模块名称

完成删除后，提交到仓库即可。

---