备份Git裸仓库未保存子仓库，如何恢复丢失的工作内容？

Git会自动将嵌套的Git仓库识别为未初始化的子模块，这种情况下ParentRepo并不会跟踪ChildRepo的实际文件内容，只会在目录里留下一个空占位项（或仅记录子模块的引用信息）。备份ParentRepo为裸仓库时，只会备份ParentRepo自身的版本数据，ChildRepo的内容完全不在备份范围内，因此恢复后ChildRepo目录是空的。

1. 检查原损坏目录的残留 #

如果原ParentRepo的损坏目录还未被彻底删除：

• 进入原ParentRepo的ChildRepo目录，查看是否存在.git文件夹。若有，直接将整个ChildRepo目录复制到恢复后的ParentRepo对应位置，即可恢复所有工作内容。

2. 查找本地Git对象库的残留 #

如果原目录已被清理，尝试从本地Git的对象数据库中恢复：

• 切换到原ParentRepo所在的磁盘位置，运行：

  git fsck --full --no-reflogs
  

  该命令会扫描所有未被引用的Git对象（包括可能属于ChildRepo的提交、Blob）。
• 若扫描到可疑对象（比如大体积的Blob，对应文件内容），用git show <对象哈希值>查看内容，确认是否属于ChildRepo。
• 确认后，用git checkout <对象哈希值> -- path/to/ChildRepo将文件恢复到指定目录。

3. 检查本地其他克隆/备份 #

回忆是否在本地其他位置克隆过ChildRepo，或者有过其他备份（比如本地临时克隆、IDE历史快照等），这些都可能是内容恢复的来源。

方案一：使用正式子模块（保留ChildRepo独立版本控制） #

如果需要ParentRepo和ChildRepo保持独立版本控制：

• 在ParentRepo中初始化子模块：

  git submodule add <ChildRepo远程仓库地址> path/to/ChildRepo
  

• 提交子模块配置：

  git add .gitmodules path/to/ChildRepo
  git commit -m "Add ChildRepo as submodule"
  

• 备份ParentRepo裸仓库时，带上子模块递归参数：

  git clone --bare --recurse-submodules ParentRepo ParentRepo-bare.git
  

方案二：合并仓库（将ChildRepo文件纳入ParentRepo） #

如果不需要ChildRepo独立版本控制，直接将其合并到ParentRepo：

• 删除ChildRepo目录下的.git文件夹
• 将ChildRepo的所有文件添加到ParentRepo：

  git add path/to/ChildRepo
  git commit -m "Merge ChildRepo files into ParentRepo"
  

  这样备份ParentRepo时就会包含所有ChildRepo的文件内容。

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