打造AI代码审查员：使用 Gemini + Git Hooks 自动化 Code Review前言传统 Code Re

前言

传统 Code Review 的痛点：反馈周期长、审查者耗费心力在琐碎的格式和规范问题上、低级错误反复出现等。
传统的 Code Review 就像是文章写完后交给编辑进行审校；而使用 geminicli 辅助 Git 提交审查，则是在 Word 文档里内置了一个顶级的语法和风格检查器，在每次“保存”时，它都会提供专业的修改建议。

效果示例

在 for 循环中删除 key，然后调用 git commit 提交，触发 ai 审核。

GIF 2025-9-4 10-14-53.gif

准备工作

安装 Gemini Cli 且完成认证

详见 Gemini CLI 安装和使用教程（新手入门指南）

核心机制 Git Hooks

Git Hooks 是一些在 Git 执行特定事件（如 commit, push, receive 等）时自动运行的脚本。我们正好可以利用这个特性，在代码被“提交”或“推送”之前，执行一个调用 Gemini API 的脚本来分析代码。

对于我们的需求，最合适的钩子是 pre-commit 或 pre-push：

pre-commit 钩子：在你执行 git commit 命令后，但在 Git 要求你输入 commit message 之前运行。如果这个脚本以非零状态退出，Git 将会中止本次提交。这是最适合场景的钩子，因为它可以在代码进入本地仓库前就进行检查，让你有机会立即修改。
pre-push 钩子：在你执行 git push 命令后，但在任何代码被推送到远程仓库之前运行。如果脚本失败，推送也会被中止。这个也可用，但反馈链条比 pre-commit 更长一些。

具体实现

进入项目目录，然后找到 .git/hooks 文件夹。
在该文件夹内，创建一个名为 pre-commit 的文件。
注意：文件名就是 pre-commit，不要带任何后缀。
编写脚本（内容可根据实际调整）：

#!/bin/sh
# 上面这行 #!/bin/sh 对于在 Windows 的 Git 环境中正确执行至关重要！

echo ""
echo "[AI Code Review] 正在准备代码进行 AI 分析..."

# 1. 获取所有暂存的代码变更
STAGED_DIFF=$(git diff --cached -- . ':(exclude)*.lock' ':(exclude)package*.json')

# 如果没有暂存的代码变更，则直接退出
if [ -z "$STAGED_DIFF" ]; then
    echo "[AI Code Review] 没有发现暂存的代码变更。跳过分析。"
    exit 0
fi

echo "[AI Code Review] 正在调用 Gemini 进行代码审查，请稍候..."

# 2. 准备发送给 Gemini 的 Prompt，并通过管道传递
# 我们将 Prompt 和代码变更内容一起通过标准输入传给 gemini 命令
AI_FEEDBACK=$(cat <<EOF | gemini
你是一名资深软件工程师，正在进行代码审查(Code Review)。
请严格、专业地分析以下代码变更(以 git diff 格式提供)。
你的分析应集中在以下几个方面：
1.  **代码质量**: 是否存在冗余代码、不合理的逻辑或坏味道？
2.  **潜在 Bug**: 是否有明显的逻辑漏洞、边界条件问题或空指针风险？
3.  **性能优化**: 是否有可以提高性能的写法？
4.  **代码规范和可读性**: 代码是否遵循通用规范？命名是否清晰？

请以清晰、简洁的要点形式给出你的建议。如果代码质量很好，没有需要修改的地方，请只回复“代码质量优秀，无修改建议。”这句话，不要添加任何其他内容。

这是需要你审查的代码变更：
\`\`\`diff
$STAGED_DIFF
\`\`\`
EOF
)

# 3. 检查 gemini 命令是否成功执行
if [ $? -ne 0 ]; then
    echo ""
    echo "[AI Code Review] 错误：调用 'gemini' 命令失败。"
    echo "请确认 'gemini' 已经正确安装并且在其路径在系统 PATH 环境变量中。"
    echo "本次提交将继续，但未进行 AI 审查。"
    exit 0
fi

# 4. 显示 AI 的反馈
echo ""
echo "------------------- Gemini 代码审查报告 -------------------"
echo "$AI_FEEDBACK"
echo "-----------------------------------------------------------"
echo ""

# 5. 交互式地决定是否继续提交
# 使用 grep -q 来安静地检查字符串是否存在
if ! echo "$AI_FEEDBACK" | grep -q "代码质量优秀，无修改建议。"; then
    # 在 Windows 的 Git Bash 中，需要用 -n 1 和特定的提示格式
    echo "AI 提出了以上建议，你是否要中止提交以修改代码？(y/N)"
    read -r answer < /dev/tty
    if [ "$answer" = "y" ] || [ "$answer" = "Y" ]; then
        echo "[AI Code Review] 提交已中止。请根据建议修改代码后重试。"
        exit 1 # 退出码为 1，中止 git commit
    else
        echo "[AI Code Review] 用户选择继续提交..."
        exit 0 # 退出码为 0，继续 git commit
    fi
else
    echo "[AI Code Review] ✅ 代码质量优秀！将自动继续提交。"
    exit 0
fi

4. 授予执行权限: 打开 Git Bash 终端（在项目文件夹点右键，选择 Git Bash Here）。
然后运行以下命令：
chmod +x .git/hooks/pre-commit

如何一次配置，所有项目通用？

问题：在多个项目中维护相同的钩子脚本，如果靠复制粘贴，后期会越来麻烦。
解决：使用全局钩子路径 (Global Hooks Path)
操作：
在电脑中任意创建 .githooks 目录(创建全局钩子目录)，并且将pre-commit脚本移动到该位置，然后执行以下命令就可以了。

git config --global core.hooksPath <你的目录路径>

示例：
git config --global core.hooksPath 'C:/Users/你的用户名/.githooks'

优先级规则 ：这个全局设置非常智能，它不会“霸道地”覆盖所有情况。Git 的钩子查找优先级是：

首先，检查项目本地的 .git/hooks/ 目录。如果这里面有 pre-commit 脚本，就用它。
其次，如果本地没有，Git 会检查是否通过 git config core.hooksPath （不带 --global）设置了项目级的钩子路径。
最后，如果以上都没有，Git 才会去查找你用 --global 设置的全局钩子路径 ~/.githooks/。

这意味着，如果某个特定项目需要一个不同于全局规则的钩子，你仍然可以在那个项目的 .git/hooks/ 目录里放一个专门的脚本来覆盖全局设置，提供了极大的灵活性。

如何作用于团队？

Git 2.9 版本以上支持一个名为 core.hooksPath 的配置，允许将钩子脚本存放在项目目录下的一个普通文件夹里，并让 Git 从那里读取。

在项目根目录创建一个新文件夹，比如叫 .githooks。
将 pre-commit 脚本移动到这个新文件夹里。
将 .githooks 文件夹添加到版本控制。
通知所有团队成员，在他们第一次拉取代码后，只需在各自的电脑上为这个项目执行一次以下命令：
```
git config core.hooksPath .githooks
```
这个命令会告诉 Git：“不要用默认的 .git/hooks 目录了，请使用项目根目录下的 .githooks 文件夹作为钩子目录。”

优点：无需任何第三方工具，纯 Git 功能。
缺点：需要团队成员手动执行一次配置命令。新人加入时需要告知。

总结

通过在开发流程的最前端建立一个低成本、高效率、智能化的质量反馈机制，从而系统性地提升代码入库的基线质量，解放人类审查者去关注更有创造性的工作，最终实现研发效率和软件质量的双重飞跃。