如何在Git pre-commit钩子中拆分提交为单文件独立提交？

问题根源 #

你当前的脚本逻辑有两个核心问题：

• 执行git commit --no-verify时，Git会基于当前暂存区创建新提交，但原暂存区的内容并没有被清空，钩子执行完后Git还会尝试创建最初的那个提交（就是用户触发的那次），导致重复状态。
• git reset HEAD在你的脚本里无效，大概率是因为你在拆分提交前没先处理原暂存区，或者钩子的执行上下文没对齐。

修正后的脚本逻辑 #

直接修改pre-commit钩子，按以下步骤执行：

#!/bin/sh

# 1. 先把当前暂存的所有内容回退到工作区，避免后续提交冲突
git reset HEAD

# 2. 获取所有待提交的修改文件（这里用diff-index确保只拿到已修改的文件）
FILES=$(git diff-index --name-only HEAD)

# 3. 遍历每个文件，单独添加并提交
for FILE in $FILES; do
    # 只添加当前文件
    git add "$FILE"
    # 从第三方系统获取该文件的专属注释，这里替换成你的实际逻辑
    COMMENT=$(your-command-to-get-unique-comment "$FILE")
    # 提交，--no-verify避免再次触发pre-commit钩子，防止无限循环
    git commit -m "$COMMENT" --no-verify
done

# 4. 返回非0值，告诉Git不要创建最初的那个空提交（我们已经拆分完成了）
exit 1

关键说明 #

• 为什么要先git reset HEAD？：用户触发提交时，Git已经把所有修改加到了暂存区，先回退能确保我们从干净的状态开始逐个提交，避免原暂存区内容残留导致的重复状态。
• 为什么要exit 1？：pre-commit钩子返回0时，Git会继续执行原来的提交流程，这会在我们拆分的多个提交后再创建一个空提交（因为暂存区已经被清空了），返回非0值会终止原提交流程，只保留我们拆分的单独提交。
• 关于第三方注释获取：把your-command-to-get-unique-comment "$FILE"替换成你实际调用第三方系统的命令，确保每个文件能拿到对应的专属注释。

验证效果 #

修改完钩子后，用户正常执行git commit（不需要加任何参数），钩子会自动把所有待提交文件拆分成单独的带专属注释的提交，执行git status后不会出现异常状态，也不需要用户手动执行reset。

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