如何将frontend仓库作为子模块加入Git主仓库并解决相关报错

第一步：清理本地主仓库的无效frontend索引条目 #

你本地主仓库（nodeandreactwithdatabase）的Git索引已经残留了无效的frontend记录，才会触发already exists报错，先执行以下清理操作：

• 进入本地主仓库的根目录，提前备份所有未提交的本地代码，避免操作中数据丢失
• 执行命令删除索引里的frontend条目：git rm --cached frontend
  注意：该命令只会删除Git索引中的记录，不会删除你本地实际存储的frontend代码，无需担心数据丢失
• 如果提示fatal: pathspec 'frontend' did not match any files，说明是子模块残留记录，执行额外清理命令：

  git rm -rf --cached frontend
  rm -rf .git/modules/frontend
  git config --remove-section submodule.frontend 2>/dev/null
  

• 把本地的frontend文件夹暂时剪切到主仓库外做备份（比如桌面），避免后续操作冲突

第二步：同步远程主仓库内容，解决push被拒问题 #

你本地主仓库的提交记录落后于远程版本，才会出现push被拒的报错，先完成远程内容同步：

• 拉取远程最新代码合并到本地：git pull origin main
  如果出现合并冲突，按提示解决冲突后执行git add .和git commit -m "resolve merge conflict"即可
• 确认本地与远程代码同步完成后，提交当前的清理修改：

  git add .
  git commit -m "clean invalid frontend index record"
  

第三步：正确添加frontend仓库为子模块 #

现在环境清理完成，可正常添加子模块：

• 执行子模块添加命令，指定存储路径为根目录下的frontend：git submodule add https://github.com/phershbe/frontend.git frontend
• 初始化并拉取子模块的最新代码：

  git submodule init
  git submodule update
  

• 如果你要用之前备份的本地frontend代码覆盖子模块内容，直接把备份的frontend文件全部替换当前主目录下新生成的frontend文件夹内容即可，替换后进入frontend文件夹提交代码到独立的frontend远程仓库：

  cd frontend
  git add .
  git commit -m "update latest frontend code"
  git push origin main
  cd .. # 回到主仓库根目录
  

第四步：提交主仓库修改并推送 #

• 提交主仓库的子模块配置变更：

  git add .gitmodules frontend
  git commit -m "add frontend as submodule"
  git push origin main
  

• 操作完成后打开GitHub主仓库页面，即可看到frontend文件夹可正常点击跳转，本地与远程目录结构完全一致。

如果你不需要维护独立的frontend仓库，只是希望frontend作为普通文件夹存在主仓库，和本地运行结构完全一致，可按以下操作：

• 完成第一步的清理操作后，把备份的frontend文件夹移回主仓库根目录
• 进入frontend文件夹，删除里面的.git隐藏文件夹（该文件夹是frontend作为独立仓库的Git配置，删除后就会被主仓库识别为普通文件夹）
• 直接提交推送即可：

  git add .
  git commit -m "add frontend code as normal folder"
  git push origin main
  

该方案上传后GitHub里的frontend就是普通可浏览的文件夹，所有代码都存储在主仓库中，无需关联子模块。

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