AI 怎么把 git diff 交给模型做代码审查
把改动差异交给模型审查,关键在只看变更、控制行数、结果可回写。差异太大或上下文太少,报出来的问题反而误导人。
让模型审代码,最容易犯的错是把整个仓库丢进去。真正有效的做法是只喂这次改动的差异,配上够用的上下文,再要求它按固定结构输出问题清单。这篇只讲差异审查这一条链路。
入口在哪
- 终端里用版本控制工具的差异命令,可以直接拿到补丁文本。
- 代码托管平台的合并请求页面本身能复制完整补丁,也能把结果回写成评论。
- 编辑器里的编程助手面板通常有选中差异或选中文件的入口,适合小改动单点审查。
具体步骤
- 只取本次改动。用三点写法与分叉点比较,例如
git diff --unified=3 main...HEAD,带三行上下文足够判断改动意图。 - 排除噪声文件,锁文件、构建产物、压缩后的前端资源一律剔掉。这些文件差异动辄上万行,进去只会把真正的改动挤掉。
- 按文件拆成多次请求,一个文件一条。提示里写清楚:只审这次改动涉及的行,指出风险和漏掉的边界,不要重写整个文件。
- 约定输出结构:文件、行号、问题类型、严重程度、修改建议,按严重程度排序。结构固定了,才能用脚本汇总成一张表。
- 把结果落到合并请求评论或一份 Markdown 清单里,逐条人工确认后再动代码。
- 放进持续集成时设一个差异行数上限,比如单次五百行,超了自动按文件拆分,避免被静默截断。
几个坑
- 上下文给太少会把合理写法判成错误。函数头被截掉时它看不到参数类型,指责往往落空。至少给到完整函数或三行上下文。
- 差异里可能带密钥、内网地址、真实用户数据。外发前先确认合规,必要时先替换成占位符。
- 它给的改法可能破坏项目既有约定。别直接应用补丁,先看测试能不能过,再决定采纳。
- 二进制文件和大文件的差异没有可读内容,喂进去纯烧额度。上线前先按扩展名过滤,注意按量计费的费用会随差异行数线性增长。
怎么验证
找两条历史提交回放:一条是修过线上问题的真实改动,一条是纯格式化、逻辑没变的改动。前者应该能点出关键风险,后者不该报一堆严重问题。两个方向都对,说明提示和上下文范围基本调好了。
常见问题
差异一千多行,一次能喂完吗?
不建议。多数模型长输入下后半段关注度会下降,还容易被截断。按文件或按模块切成几次,每次带一句本次改动的目标,比一次全塞准确率高得多。
它总挑格式问题,不提逻辑问题怎么办?
把格式类问题明确排除,并在提示里给出关注清单:边界条件、错误处理、并发、空值、资源释放。窄化范围之后它才会往深里看,而不是停在缩进和命名上。
审查结果怎么和人工评审配合?
把它当第一遍粗筛,负责找遗漏和可疑点;人工评审负责判断能不能合并。机器结论永远不设为合并门槛,否则团队会被误报拖慢。
一句话总结:只喂本次差异、给够上下文、输出固定结构,模型审代码才省时间而不是制造噪声。