Git中如何暂存手动移动文件的部分改动完成部分提交？

核心逻辑：先让Git正确识别手动移动的文件重命名关系，再通过补丁匹配的方式批量暂存仅包名相关的改动，全程无需手动指定单个文件名，其他业务改动会完整保留在工作区不会被误提交。 #

步骤1：临时加入所有改动触发Git重命名检测 #

手动移动文件后Git默认会识别为「旧文件删除+新文件未跟踪」，先临时把所有改动加入暂存区，让Git自动匹配重命名关系：

# 把所有删除、新增、修改的改动临时加入暂存区
git add -A
# 开启重命名检测，调高文件数量上限适配大量文件移动的场景
git config diff.renames true
git config merge.renameLimit 999999

执行完可以跑git status验证，原来的大量删除、未跟踪文件会被配对为renamed: 旧文件路径 -> 新文件路径的重命名条目。

步骤2：清空暂存区，保留工作区所有改动 #

刚才的操作只是为了让Git识别重命名，现在清空暂存区，本地工作区的所有代码改动不会受任何影响：

git reset

步骤3：一键批量暂存所有包名改动 #

直接生成仅包含包名修改的补丁，应用到暂存区，所有非包名的改动都不会被加入暂存区：

# 提取所有Kotlin文件中package声明行的改动，直接加入暂存区
git diff -G '^package ' -- '*.kt' | git apply --cached

如果你的项目里有非kt文件也改了包名，把命令里的-- '*.kt'去掉即可。

步骤4：验证暂存内容后提交 #

先检查暂存区内容是否符合预期：

# 查看暂存区的所有改动
git diff --cached

确认输出中每个文件的改动只有顶部package行的变更，没有其他业务代码、配置的改动，就可以正常提交：

git commit -m "chore: update package declarations after file relocation"

注意事项 #

• 如果存在少量文件因为改动幅度过大没有被Git识别为重命名，单独对这些文件执行git mv 旧文件路径 新文件路径修正重命名关系，再重新执行步骤3的命令即可，不需要批量处理所有文件。
• 如果暂存后发现有多余的非包名改动被误加入，可以执行git reset -p交互式取消暂存对应块，操作逻辑和git add -p一致。
• 所有未被暂存的业务代码改动会完整保留在本地工作区，后续可以按正常流程分批次提交。

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