开发与工程 · 进阶
代码评审(Code Review)
把改动交给别人(或 AI)读一遍、挑问题、提建议,确认没大毛病之后才合进正式项目。重点是靠另一个视角发现自己的盲区。
TL;DR三十秒版本
- 把自己的改动交给别人读一遍、挑问题、给建议,再决定合不合。
- 它的重点是借第二双眼睛,发现作者自己看不见的盲区。
- 被挑出问题不代表你不行,只说明这份改动被认真看过了。
Overview详细说说
代码评审是指写代码的人把自己的改动交给别人看一遍,请对方指出问题、提改进建议,确认没问题才合入正式项目。它是一道人工质检,重点不是跑一遍看能不能用,而是靠经验发现隐患。规模可大可小,改几行也可以请人看一眼,改一大块则必须过这一关。
需要它,是因为写的人有盲区。自己刚写好的逻辑,怎么看都顺;换个人看,往往立刻看出漏洞、命名混乱、边界情况没处理。评审顺手也完成了知识共享——改动以后出问题,至少有第二个人了解它。
这一步现在越来越多交给 AI 来做。你常见的互动形式是:它读完给出几条意见,你来判断哪条值得采纳、哪条可以先放着。有些团队还会把意见分等级:必须改的、建议改的、可以商量的,你不用每一条都当成命令。
别把它当挑刺比赛。意见里的重点通常是“这里可能有问题”,目的是把隐患提前挖出来。被指出问题不代表你不行,反而说明改动被认真看过一遍。
反过来,无人反对也不等于没问题。评审的有效性取决于看的人愿不愿意花时间,草草一句看起来没问题,通过得很快,也拦不住什么。想让评审真正有用,改动别一次太大,几百行的内容谁看了都容易走个过场。
Myths常见误解
- ✕以为评审只是走个形式 ✓看得认不认真差别很大,草草一句“没问题”拦不住任何隐患
- ✕以为意见都得照单全改 ✓意见常分必须改、建议改和可商量,采纳与否由你判断
- ✕以为没人反对就说明没问题 ✓通过得很快,常常只是没人真花时间细看
In practice你会在哪用到它
- 改动做好后请同事看一遍,等他给出意见再合入
- 让 AI 先读一遍这版改动,把可疑的地方列出来
- 收到评审意见时,先分清哪条必须改、哪条可以先放着
Summary记住这几点就够了
- 把改动交给别人看一遍,确认后再合入正式项目
- 靠第二个人的视角发现作者自己的盲区
- 现在常常由 AI 充当审阅者,意见采纳与否仍由你判断
- 被指出问题是改动被认真看过的证明
常见问题
代码评审(Code Review)是什么意思?
把自己的改动交给别人读一遍、挑问题、给建议,再决定合不合。它的重点是借第二双眼睛,发现作者自己看不见的盲区。被挑出问题不代表你不行,只说明这份改动被认真看过了。
代码评审(Code Review)一般用在什么地方?
改动做好后请同事看一遍,等他给出意见再合入;让 AI 先读一遍这版改动,把可疑的地方列出来;收到评审意见时,先分清哪条必须改、哪条可以先放着。
关于代码评审(Code Review),最容易搞错的是什么?
以为评审只是走个形式,其实看得认不认真差别很大,草草一句“没问题”拦不住任何隐患;以为意见都得照单全改,其实意见常分必须改、建议改和可商量,采纳与否由你判断。
代码评审(Code Review)要记住哪几点?
把改动交给别人看一遍,确认后再合入正式项目;靠第二个人的视角发现作者自己的盲区;现在常常由 AI 充当审阅者,意见采纳与否仍由你判断;被指出问题是改动被认真看过的证明。
容易踩的坑 没人反对不代表没问题,草草通过的评审拦不住隐患。
Also written as你可能还会看到这些写法
这些都是同一个概念,在技能介绍里指代的是同一件事 —— 不必因为写法不同而以为是两个东西。
全站第 80 / 186 条 · 全部词条
接着读Related reading
算法(Algorithm)
算法就是做一件事的固定步骤清单。照着一步步做,同样的输入总能得到同样的结果,电脑就是靠它来完成任务的。
开源(Open Source)
开源就是作者把软件的配方和做法都公开出来,谁都能免费看、免费用,还能改了再分享给别人。
GitHub(代码托管平台)
GitHub 是全球程序员存放和分享代码的网站,既能当作品集,也是大家一起改同一份代码的协作台。
前端(Frontend)
前端是软件里你能看见、能点的那一层。按钮、图片、页面动画,都是它做出来的。
后端(Backend)
后端是软件里用户看不见的那一半。你在界面上点的每一步,背后都由它去查数据、做判断。
自动化(Automation)
自动化就是让电脑按你定好的规则重复做事,把每次都要手动做一遍的活整个交出去。