推送项目到GitHub时出现Nested repository嵌套仓库是什么原因？

问题原因 #

• 你的前端或后端子文件夹曾经单独执行过git init初始化了独立Git仓库，子文件夹内存在隐藏的.git目录
• 主项目文件夹初始化Git仓库后，Git会自动识别到子目录下的独立仓库，将其标记为嵌套仓库，不会同步子目录内的实际文件到主仓库，仅会存储一个指向子仓库的哈希引用，最终表现为推送后GitHub上子文件夹无法点击查看完整内容。

解决方案 #

根据你是否需要保留子文件夹的独立Git提交历史，可选择对应方案：

方案1：不需要保留子仓库提交历史（适用绝大多数场景） #

1. 在本地主项目根目录执行命令，删除Git对嵌套仓库的缓存引用：

# 替换为实际的子文件夹名称，如有多个子仓库依次执行即可
git rm --cached FrontEnd
git rm --cached BackEnd

2. 进入对应子文件夹，删除内部隐藏的.git目录：
   • Windows：开启文件管理器的「显示隐藏的项目」选项，找到.git文件夹直接删除
   • macOS/Linux：在子文件夹目录下执行rm -rf .git
3. 回到主项目根目录，重新提交文件：

git add .
git commit -m "移除嵌套仓库，合并前后端项目文件"
git push

方案2：需要保留子仓库独立提交历史 #

如果需要保留前端、后端项目的独立提交记录，可将其配置为Git子模块关联到主仓库：

1. 先执行缓存删除操作：

git rm --cached FrontEnd
git rm --cached BackEnd

2. 在主仓库根目录执行命令添加子模块，替换为对应子仓库的远程仓库地址：

git submodule add https://github.com/你的账号/前端仓库名.git FrontEnd
git submodule add https://github.com/你的账号/后端仓库名.git BackEnd

3. 提交子模块配置并推送：

git add .gitmodules FrontEnd BackEnd
git commit -m "添加前后端子模块配置"
git push

配置完成后主仓库会关联对应子仓库地址，可分别维护主仓库和子仓库的提交记录。

提示：操作前建议先备份完整项目文件夹，避免误操作导致文件丢失。

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