如何移除新Git仓库中无意添加的多余子模块？

1. 检查并解除主文件夹的Git仓库身份 #

你怀疑存放所有仓库的GitHub主文件夹被误设为Git仓库是核心问题，先验证并清理：

• 打开Git Bash，进入GitHub主文件夹：

  cd /path/to/你的GitHub主文件夹路径
  

• 查看是否存在隐藏的.git目录（Git仓库的核心标识）：

  ls -la
  

• 如果看到.git目录，直接删除它，彻底取消这个文件夹的仓库身份：

  rm -rf .git
  

2. 清理现有仓库中的子模块残留 #

针对已经出现问题的仓库（比如simple-form），清理Git索引中的子模块记录：

• 进入目标仓库：

  cd /path/to/GitHub/simple-form
  

• 单个删除子模块条目（替换成实际的子模块文件夹名，比如eyes）：

  git rm --cached eyes
  

• 如果有多个子模块，批量清理：

  git submodule--helper list | awk '{print $2}' | xargs git rm --cached
  

• 提交并推送更改到远程：

  git commit -m "移除误添加的子模块"
  git push origin main  # 替换成你的分支名，比如master
  

3. 重新创建干净的新仓库（可选） #

如果现有仓库已经混乱，可彻底重建：

• 先在GitHub网页端删除对应的远程仓库
• 删除本地仓库文件夹：

  rm -rf /path/to/GitHub/simple-form
  

• 重新初始化仓库：

  mkdir simple-form
  cd simple-form
  git init
  git remote add origin https://github.com/你的用户名/simple-form.git
  # 初始化提交
  echo "# simple-form" >> README.md
  git add README.md
  git commit -m "Initial commit"
  git push -u origin main
  

问题根源解释 #

当父文件夹被初始化为Git仓库时，Git会自动将内部的Git仓库识别为子模块，这就是你创建新仓库时出现蓝底白箭头文件夹的原因。删除主文件夹的.git目录后，后续创建的仓库会独立成为单独的Git仓库，不会再关联其他仓库作为子模块。

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