终端 Git Diff 配合 AI 快速代码审查:打造两分钟代码合入检查流

作为脱产在众创空间自学的单兵开发者,我们没有团队资深同事帮我们提 PR、做 Code Review。很多时候自己写了一整天代码,脑子处于疲劳状态,很容易在提交时带入一些不小心的 Bug、未注释的临时调试代码或者低效的内存拷贝。
为了让自己每天产出的代码始终维持在生产级标准,我结合终端 Git 工具与本地大模型,打造了一套极简、高产、两分钟即可完成的“Git Diff 自动化代码审查流”。
今天把这套工作流的 Shell 脚本配置、Prompt 设计以及审查清单完整分享出来。
1. 为什么传统的网页 Review 效率低下?
很多自学者尝试把代码打包贴进 ChatGPT 网页端做审查,但经常面临三个痛点:
- 全量代码噪声过多:把整个 500 行的
parser.rs丢进去,AI 往往会给出很多泛泛而谈的建议,忽视了真正修改的那 10 行关键代码; - 上下文缺失:如果只贴修改的 10 行,AI 又不知道周围的函数签名和结构体字段;
- 操作繁琐:复制粘贴来回切换窗口,极大打断了提交心流。
我们的核心思路是:仅提取 Git 暂存区(Staged Changes)的统一差异(Unified Diff),并附带周围 5 行上下文,由专用终端脚本直接管道喂给模型进行靶向审查。
2. 自动化审查流水线脚本:scripts/ai-review.sh
在项目根目录下编写 Shell 脚本:
#!/usr/bin/env bash
# scripts/ai-review.sh
set -e
# 1. 检查是否有暂存区代码
STAGED_DIFF=$(git diff --cached --unified=5)
if [ -z "$STAGED_DIFF" ]; then
echo " 暂存区为空!请先使用 git add 暂存需要审查的代码变更。"
exit 1
fi
echo "=== 正在提取 Git 差异并调用本地 AI 进行架构与内存审查... ==="
# 2. 构造专用的严苛 Review 提示词
SYSTEM_PROMPT="你是一名负责 Google/Linux 内核级 Rust 开源项目的资深审查专家。
请对以下 Git Diff 补丁进行严谨的代码审查(Code Review)。
审查重点(只关注以下 5 项硬指标,无废话):
1. 【内存安全与拷贝】:新增代码中是否存在无谓的 .clone()、深拷贝或未优化的堆分配?
2. 【异常防御】:是否存在未经处理的 .unwrap()、.expect() 或可能发生数组切片越界的代码?
3. 【并发与异步】:是否存在跨 await 持有同步锁、或在异步 Worker 中调用同步阻塞 IO?
4. 【错误处理】:领域错误是否使用了 thiserror/anyhow 强类型,错误链上下文是否完整?
5. 【代码坏味道】:命名是否符合 Rust API 规范,是否有遗留的 dbg!/println! 临时调试日志?
如果发现问题,按 [严重/警告/建议] 级别给出具体文件名、行号与重构代码;若无任何问题,直接输出' 代码质量完美,准予合入!'。"
# 3. 管道调用大模型 API 并流式输出
curl -s https://api.deepseek.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-d @- <<EOF | jq -r '.choices[0].message.content'
{
"model": "deepseek-chat",
"messages": [
{"role": "system", "content": "$SYSTEM_PROMPT"},
{"role": "user", "content": $(echo "$STAGED_DIFF" | jq -s -R .)}
],
"temperature": 0.1
}
EOF
给脚本赋予执行权限:
chmod +x scripts/ai-review.sh
3. 一次真实的实战拦截案例
在今天重构 TCP 会话管理时,我暂存了一段看似正常的代码:
// 暂存的代码片段 (git diff 中)
pub fn update_flow_timestamp(&mut self, flow_id: u64) {
let now = std::time::SystemTime::now();
// 疏忽点:为了更新时间,竟然把整个 Session 从哈希表 clone 出来再放回去!
if let Some(mut session) = self.sessions.get(&flow_id).cloned() {
session.last_seen = now;
self.sessions.insert(flow_id, session);
}
}
在终端敲下 ./scripts/ai-review.sh,仅过了两秒钟,终端立即弹出了刺眼的红色告警:
================================================================================
【严重】crates/packet-filter/src/session.rs: 第 45 行
- 问题类型:严重性能劣化 (Redundant Full Clone)
- 审查分析:为了更新 last_seen 时间戳字段,使用了 .cloned() 将包含几十 KB 报文缓存的整个 Session 进行了全量深拷贝,随后又 insert 覆盖,带来了极其严重的无谓堆分配与性能损耗。
- 重构建议:直接使用 HashMap::get_mut 原地就地修改字段:
if let Some(session) = self.sessions.get_mut(&flow_id) {
session.last_seen = now;
}
================================================================================
看到这条反馈,我倒吸了一口凉气。如果把这行代码合入主分支,每秒上万个报文进来,系统会瞬间被垃圾内存分配压垮。
我立刻按照建议修改代码,再次运行 ./scripts/ai-review.sh:
代码质量完美,准予合入!
4. 集成 Git Pre-commit 钩子
为了防止自己忘记手动执行,我把该流程配置进了 Git Hook:
在 .git/hooks/pre-commit 中:
#!/usr/bin/env bash
./scripts/ai-review.sh
从此,每一次 git commit 时,大模型都会在后台自动为我站岗放哨,坚决把任何低级 Bug 拦截在版本库大门之外。
总结
两分钟代码合入检查流的实操价值:
- 聚焦增量:仅审查 Git Diff,剔除 90% 的无关上下文噪声;
- 全自动化:绑定 Pre-commit 钩子,形成钢铁般的工程纪律;
- 自学者最强副驾:让大模型充当 24 小时全天候在线的严苛导师,持续倒逼代码质量向大厂标准对齐。
322



被折叠的 条评论
为什么被折叠?



