如何让Git外层仓库将子模块视为普通目录并追踪变更？

方案一：用Git Subtree把子模块转成普通文件夹（推荐） #

Git Subtree能把私有GitHub仓库的内容合并到你的GitLab外层仓库里，变成一个普通文件夹，同时还能和原GitHub仓库保持双向同步，完全符合你的要求：

1. 先移除现有子模块 #

如果已经有子模块了，先清理掉：

# 取消子模块关联
git submodule deinit -f path/to/submodule
# 删除本地子模块的缓存文件
rm -rf .git/modules/path/to/submodule
# 从外层仓库移除子模块目录的跟踪
git rm -f path/to/submodule

2. 用subtree引入GitHub私有仓库 #

把GitHub仓库作为子树合并到外层仓库的指定目录：

# 把GitHub仓库添加为外层仓库的远程（命名为github-subrepo，方便后续操作）
git remote add -f github-subrepo git@github.com:你的用户名/私有仓库名.git
# 将GitHub仓库的main分支合并到外层仓库的submodule-dir目录（--squash可选，用来压缩历史）
git subtree add --prefix=submodule-dir github-subrepo main --squash

• 加--squash会把GitHub仓库的所有历史压缩成一个提交，避免外层仓库历史太杂；如果需要保留完整历史，去掉这个参数就行。

3. 双向同步变更 #

• 从GitHub拉更新到外层仓库：

git subtree pull --prefix=submodule-dir github-subrepo main --squash

• 把外层仓库里子目录的修改推回GitHub：

git subtree push --prefix=submodule-dir github-subrepo main

这样处理后，submodule-dir就是外层GitLab仓库里的普通文件夹，所有成员在GitLab上直接就能看到里面的所有文件，而且你还能继续和原GitHub私有仓库同步修改。

方案二：GitLab镜像GitHub私有仓库，替换子模块地址 #

要是不想改子模块的使用方式，也可以在GitLab上镜像你的GitHub私有仓库，然后把外层仓库里的子模块地址换成镜像地址：

1. 在GitLab创建镜像仓库 #

1. 登录GitLab，新建项目时选「导入项目」→「GitHub」
2. 授权GitLab访问你的GitHub账号，选中要镜像的私有仓库，勾选「Mirror repository」
3. 设置自动同步的频率（比如每小时同步一次）

2. 修改外层仓库的子模块地址 #

# 把原GitHub子模块地址换成GitLab镜像地址
git config submodule.path/to/submodule.url git@gitlab.com:你的GitLab用户名/镜像仓库名.git
# 提交这个地址变更
git add .gitmodules
git commit -m "更新子模块地址为GitLab镜像仓库"

这样其他成员拉取外层仓库后，子模块会从GitLab镜像拉取，他们可以直接在GitLab上查看子模块的内容；而镜像会自动同步GitHub仓库的变更，你依然可以向原GitHub仓库提交修改，之后镜像会自动同步到GitLab。

注意：这个方案下，外层仓库的git status还是只会显示子模块的提交状态，不会显示具体文件修改，但成员能通过GitLab镜像仓库查看子模块里的内容。

内容的提问来源于stack exchange，提问作者Celdor