如何将Git中index.d.ts的提交历史迁移到file1.d.ts？

Git 本身不存储永久的文件重命名元数据，所有文件的跨路径历史关联都是提交时按内容相似度动态计算的。之前使用git mv index.d.ts file1.d.ts操作后，若立刻在原路径新建index.d.ts写入内容，Git 计算内容相似度时会优先将同路径的新index.d.ts和旧版本index.d.ts判定为同一文件的连续修改，导致file1.d.ts被识别为全新文件，丢失历史关联。

按以下分步提交操作即可实现需求：

具体操作步骤 #

• 第一步：复制文件完成历史锚定
  不要删除原index.d.ts，先将其内容完整复制为file1.d.ts，单独提交这次变更：

  # 完整复制原文件内容到新文件
  cp index.d.ts file1.d.ts
  git add file1.d.ts
  git commit -m "chore: migrate index.d.ts content to file1.d.ts"
  

  这次提交后Git会识别到file1.d.ts和旧版index.d.ts内容100%匹配，后续追溯历史时会自动关联index.d.ts的所有旧提交到file1.d.ts。
• 第二步：重置原文件完成历史切割
  清空原index.d.ts的旧内容，仅保留简单占位（比如一行注释标记后续要写入新内容），单独提交这次变更：

  # 清空原文件旧内容，写入占位
  echo "// new type entry, to be implemented" > index.d.ts
  git add index.d.ts
  git commit -m "chore: reset index.d.ts for new content"
  

• 第三步：写入新内容正常提交
  这一步就可以直接往index.d.ts里写入你需要的全新内容，正常提交即可。Git会自动将历史边界划在第二步的重置提交上：file1.d.ts会保留所有旧index.d.ts的提交历史，新的index.d.ts历史从重置提交开始计算，不会出现历史串回的问题。

验证方式 #

操作完成后可以用以下命令分别校验两个文件的历史记录是否符合预期：

# 查看file1.d.ts的完整历史，会包含原index.d.ts的所有旧提交
git log --follow file1.d.ts
# 查看新index.d.ts的历史，仅会展示重置之后的提交记录
git log --follow index.d.ts

注意事项 #

• 不要把复制新文件、重置原文件、写入新内容三个操作合并到同一个提交中，同提交内同时存在同路径同名文件和新路径文件时，Git的相似度计算逻辑会出错，导致历史关联错位。
• 如果已经执行了错误的git mv操作，可以执行git reset HEAD~1回退到操作前的状态，再按上述步骤重新操作即可。

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