Git pre-commit钩子如何临时移除非提交变更并还原工作区状态

核心痛点说明 #

需要解决两个核心问题：

• 适配git commit <指定文件列表>这种跳过暂存区直接提交部分变更的场景
• 避免测试完成还原工作区时出现的冲突问题

首选方案：零侵入工作区测试法（无任何还原冲突风险） #

这套方案完全不需要修改当前工作区的任何内容，自然不存在状态还原的问题，适配所有提交场景：

1. 先拿到即将提交内容的树哈希，pre-commit钩子运行时git索引已经是待提交的最终状态，直接执行即可：

   COMMIT_TREE=$(git write-tree)
   

2. 把待提交内容导出到独立的临时环境运行测试，两种实现可选：
   • 小项目快速导出：

     # 创建临时目录
     TMP_DIR=$(mktemp -d)
     # 导出待提交的所有文件到临时目录
     git archive $COMMIT_TREE | tar -x -C $TMP_DIR
     # 可选：把不需要版本控制的依赖目录（比如node_modules、venv、build缓存等）软连/拷贝到临时目录，避免重复编译依赖
     # 进入临时目录执行编译、测试逻辑即可
     # 测试完成后删除临时目录
     rm -rf $TMP_DIR
     

   • 大项目低开销实现（用git工作树）：

     TMP_DIR=$(mktemp -d)
     # 创建关联当前仓库的 detached 工作树，仅检出待提交内容
     git worktree add --detach $TMP_DIR $COMMIT_TREE
     # 进入临时目录执行测试
     # 测试完成后删除工作树
     git worktree remove $TMP_DIR
     

备选方案：工作区修改还原方案（如果你必须在原工作目录执行测试） #

如果你的测试逻辑依赖原工作目录的路径、环境配置，可以用这套全量备份还原的方案，彻底避免stash冲突：

1. 全量备份当前状态

   # 备份暂存区变更
   git diff --cached > /tmp/precommit_index.patch
   # 备份工作区已跟踪文件的变更
   git diff HEAD > /tmp/precommit_workdir.patch
   # 备份未跟踪文件
   git ls-files --others --exclude-standard > /tmp/precommit_untracked.list
   tar -cf /tmp/precommit_untracked.tar -T /tmp/precommit_untracked.list
   

2. 清理工作区到待提交状态

   # 清空工作区所有变更
   git reset --hard HEAD
   git clean -df
   # 恢复待提交的暂存区内容
   git apply /tmp/precommit_index.patch --cached
   # 把暂存区内容同步到工作区，就得到了完全只有待提交变更的环境
   git diff --cached | git apply
   

3. 执行你的编译、测试逻辑
4. 还原到原始状态

   # 先清空当前工作区
   git reset --hard HEAD
   git clean -df
   # 恢复暂存区
   git apply /tmp/precommit_index.patch --cached
   # 恢复工作区变更
   git apply /tmp/precommit_workdir.patch
   # 恢复未跟踪文件
   tar -xf /tmp/precommit_untracked.tar
   # 清理临时文件
   rm -f /tmp/precommit_*.patch /tmp/precommit_*.list /tmp/precommit_*.tar
   

测试环境脚本 #

边界场景测试仓库创建脚本如下：

#!/usr/bin/env sh

set -e -x

git init test-repo
cd test-repo
git config user.email "you@example.com"
git config user.name "Your Name"

echo foo >old-file-unchanged
echo foo >old-file-changed-staged
echo foo >old-file-changed-unstaged
echo foo >old-file-changed-both
git add .
git commit -m 'previous commit'

echo bar >old-file-changed-staged
echo bar >old-file-changed-both
echo bar >new-file-staged
echo bar >new-file-both
git add .
echo baz >old-file-changed-unstaged
echo baz >old-file-changed-both
echo baz >new-file-both
echo baz >untracked-file

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