3.8 KiB
3.8 KiB
安装 Gerrit commit-msg Hook 指南
问题
推送代码时出现错误:
remote: ERROR: commit 5ee73b7: missing Change-Id in message footer
原因
Gerrit 要求每个提交都必须包含 Change-Id,用于跟踪代码变更。需要安装 commit-msg hook 来自动添加。
解决方案
方法一:使用 SCP 下载(SSH 方式,推荐)
在您的项目目录中执行:
cd /d/zhini_im_android
# 下载 commit-msg hook
gitdir=$(git rev-parse --git-dir)
scp -p -P 29419 renjianbo@101.43.95.130:hooks/commit-msg ${gitdir}/hooks/
# 如果使用 OpenSSH >= 9.0,需要添加 -O 参数
# scp -O -p -P 29419 renjianbo@101.43.95.130:hooks/commit-msg ${gitdir}/hooks/
# 设置执行权限
chmod +x ${gitdir}/hooks/commit-msg
方法二:使用 HTTP 下载(如果 SSH 有问题)
cd /d/zhini_im_android
# 下载 commit-msg hook
f="$(git rev-parse --git-dir)/hooks/commit-msg"
curl -o "$f" http://101.43.95.130:8080/tools/hooks/commit-msg
chmod +x "$f"
方法三:手动创建目录并下载
cd /d/zhini_im_android
# 确保 hooks 目录存在
mkdir -p .git/hooks
# 下载 hook(HTTP 方式)
curl -o .git/hooks/commit-msg http://101.43.95.130:8080/tools/hooks/commit-msg
# 设置执行权限
chmod +x .git/hooks/commit-msg
修复已提交的代码
安装 hook 后,需要修改最后一次提交以添加 Change-Id:
cd /d/zhini_im_android
# 修改最后一次提交(会自动添加 Change-Id)
git commit --amend --no-edit
# 重新推送
git push origin HEAD:refs/for/master
完整操作步骤
步骤 1:安装 commit-msg hook
cd /d/zhini_im_android
# 使用 HTTP 方式下载(最简单)
f="$(git rev-parse --git-dir)/hooks/commit-msg"
curl -o "$f" http://101.43.95.130:8080/tools/hooks/commit-msg
chmod +x "$f"
步骤 2:验证 hook 已安装
# 检查文件是否存在
ls -la .git/hooks/commit-msg
# 检查文件内容(应该看到 Gerrit commit-msg hook 的代码)
head -20 .git/hooks/commit-msg
步骤 3:修改提交添加 Change-Id
# 修改最后一次提交
git commit --amend --no-edit
# 查看提交信息,确认 Change-Id 已添加
git log -1
您应该看到提交信息末尾有类似这样的内容:
Change-Id: I1234567890abcdef1234567890abcdef12345678
步骤 4:重新推送
git push origin HEAD:refs/for/master
验证
推送成功后,您会看到类似这样的输出:
remote: Resolving deltas: 100% (55/55)
remote: Processing changes: refs: 1, new: 1
remote:
remote: SUCCESS
remote:
remote: http://101.43.95.130:8080/c/zhini_im_android/+/123 [NEW]
remote:
To ssh://101.43.95.130:29419/zhini_im_android
* [new branch] HEAD -> refs/for/master
后续使用
安装 hook 后,以后的所有新提交都会自动包含 Change-Id,不需要手动添加。
常见问题
Q: 如果 scp 命令失败怎么办?
A: 使用 HTTP 方式下载:
curl -o .git/hooks/commit-msg http://101.43.95.130:8080/tools/hooks/commit-msg
chmod +x .git/hooks/commit-msg
Q: 如果有多个提交需要修复怎么办?
A: 可以使用交互式 rebase:
# 假设需要修复最近 3 个提交
git rebase -i HEAD~3
# 在编辑器中,将要修改的提交标记为 "edit"
# 然后对每个提交执行:
git commit --amend --no-edit
git rebase --continue
Q: hook 安装后不工作?
A: 检查:
- 文件权限:
chmod +x .git/hooks/commit-msg - 文件路径:确保在
.git/hooks/目录下 - Git 版本:确保 Git 版本支持 hooks
注意事项
- ✅ Hook 只需要安装一次,后续提交会自动使用
- ✅ 如果克隆新项目,需要重新安装 hook
- ✅ Hook 是项目级别的,每个项目都需要单独安装