コードレビュー
Code Review
コードレビューとは?
- 同僚がコードを検討し、誤りや改善点を見つけること
- 一人では見逃すミスを捕まえる
- AIのコードもレビューが必要
コードレビューが定着すると、コードの持ち主が変わります。「これはキム代理が書いたモジュール」という言葉が消え、マージした瞬間からチーム全体が一緒に責任を負う資産になります。担当者が休暇を取ったり退職したりしても、コードが宙に浮くことはありません。同時に、問題に気づく時点が早まります。障害が起きた未明にログを追いかけて見つけていたミスを、マージ直前の質問一行で捕まえられます。レビューは日程を食いつぶす手続きではなく、後で起きるはずの時間を前倒しで使う作業です。
運営方式は大きく二つに分かれます。画面を一緒に見ながらその場でやり取りする同期レビューは、構造が大きく揺らぐ変更に向いており、PRにコメントを残す非同期レビューは日常的な変更に向いています。鍵となるのは単位です。数千行に膨らんだPRは、レビュアーが最後まで読み切れず結局承認の判を押すだけになるため、チームごとにPR一件の上限を決めて細かく分けるほうが良いでしょう。役割の境界も明確であるべきです。インデント・命名・未使用変数のような指摘はリンターや静的解析ツールに任せ、人は設計の意図と例外的な状況を見ます。動作が正しいかの確認はテストコードとQAの役目であり、レビュアーが目で実行して確かめる仕事ではありません。
現場で最も頻繁に崩れるポイントは、「承認はするが読まない」状態です。レビュアーがシニア一、二名に集中するとPRが数日間滞り、焦った作成者が「とりあえずマージして、後で見てください」と言った瞬間、レビューは形式だけが残ります。逆に、レビューを個人の好みを押し通す場にしてしまうと、ジュニアはPRを上げること自体を恐れ、変更をまとめて一度に投げるようになります。AIが生成したコードも同じで、動くからという理由で読まずにマージする習慣が積み重なると、数か月後には誰も中身を説明できないコードがサービスの中心に残ります。
ソフトウェア工学の品質管理の慣行から発展し、Git・プルリクエストの普及によって日常的な開発文化となりました。
架空の事例で見てみましょう。役職員140名規模のECプラットフォームA社は開発者が22名ですが、前四半期だけでデプロイ後のロールバックが14件発生しました。機能の日程を合わせるためにレビューなしで即マージする慣行が定着しており、決済モジュールは事実上一人だけが中身を把握していました。
- 四半期の振り返りで、CTOが「ロールバック14件のうち8件はデプロイ前に防げたもの」と指摘し、レビューなしのマージをやめることにしました。
- バックエンドのリードはPR一件を300行以内に分割させ、レビュアー2名のうち1名が承認するまではマージできないようブランチ保護を設定しました。
- 最初の2週間は規約の指摘でコメントが埋め尽くされたため、リンターと静的解析をCIに組み込み、機械が拾えるものは外して、人は設計と例外処理だけを見るようにしました。
- レビュー待ちの平均が31時間まで延びたため、毎日午前10時20分を「レビュータイム」に固定し、最初のコメントは24時間以内に付けるという約束を添えました。
- 「LGTM」の一言承認を禁止し、「決済失敗の再試行経路のみ確認しました」のように、何を見たかを残すようにしたところ、形式的な承認が目に見えて減りました。
- 3か月後、月間ロールバックが3.5件から0.8件に減り、レビュー待ちは31時間から7時間に短縮され、新人開発者のオンボーディング期間も6週間から3週間に短くなりました。
パク・ソリョン
金鍾赫