如何将git subtree转换为普通目录并保留提交历史

git subtree 与 git submodule 实现逻辑不同，其所有文件内容、提交历史默认就完整存储在主仓库的提交树中，不存在类似 submodule 的 commit 指针绑定逻辑，移除关联的操作不会影响现有文件和历史记录，可按以下步骤操作：

• 第一步：删除本地 Git 配置中的 subtree 关联项
  首先执行以下命令查看当前仓库的 subtree 配置：
  git config --local --list | grep subtree
  输出结果中匹配你目标目录的配置格式一般为 subtree.<目标目录路径>.url、subtree.<目标目录路径>.path，执行以下命令删除对应配置段即可，示例中目标目录为 third_party/foo，可替换为你实际的 subtree 目录路径：
  git config --local --remove-section subtree.third_party/foo

• 第二步：清理特殊规则（按需操作）
  检查仓库根目录、用户全局等各个层级的 .gitignore 文件，删除针对该 subtree 目录的特殊忽略规则（大部分场景下不存在这类规则，可跳过本步骤）。

• 第三步：验证配置生效
  操作完成后，该目录就已经是完全普通的 Git 托管目录，你可以正常修改、提交、推送目录内的所有内容，所有操作逻辑与仓库内其他普通目录完全一致，原有提交历史会完整保留。
  你也可以尝试执行针对该目录的 subtree 拉取命令验证关联已清除，Git 会提示找不到对应 subtree 配置，代表移除成功。

注：过往提交记录中可能存在 Git Subtree 命令自动生成的标记信息（比如提交信息里的 git-subtree-dir 字段），该内容仅为提交信息备注，不会影响 Git 对目录的识别和正常使用，无需额外修改。如果确需清除该类标记，可使用 git filter-repo 工具批量修改历史提交信息，该操作会改写提交哈希，需团队协同确认后再操作。

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