エンジニア英語

nitの意味:コードレビューの「細かい指摘」

簡単な答え

nitの意味は「細かい指摘」です。nitpick(重箱の隅をつつく)の略で、コードレビューではコメントの先頭に「nit:」とつけて、変数名や空行など重要度の低い指摘だと示します。直すかどうかは作者に任せる、という合図です。Devlingoでは、こうしたレビューの英語を例文で学べます。

更新日 3 分で読めますGambit Studio

インストールなしで使う →ブラウザで無料、登録不要

nitの意味と使う場面

英語のnitは、もともと「シラミの卵」のこと。そこから nitpick(細かいことにケチをつける)、nitpicking(あら探し)、nitpicky(重箱の隅をつつくような)という言葉が生まれました。日常会話では少し否定的な言葉ですが、コードレビューの「nit:」は、自分の指摘の重みを下げて伝える気づかいの表現です。

Googleのコードレビューガイドも、コメントに重要度のラベルをつけることを勧め、その例に「Nit: 小さなこと。本来は直したほうがいいが、大きな影響はない」を挙げています(Googleのレビューガイド)。

nitの使い方(例文)

英語意味
nit: typo in the comment ("recieve" → "receive").nit: コメントにタイプミスがあります。
nit: I'd rename this to userCount.nit: userCount という名前のほうがいいと思います。
nit: extra blank line here.nit: ここに余分な空行があります。
Nit, non-blocking: we could use an early return here.nitなので必須ではありませんが、ここは早期リターンにできます。
Just nits. LGTM otherwise.細かい指摘だけです。それ以外はLGTMです。

nitと言われたときの返し方

直したら「Fixed, thanks!」や「Good catch, done.」。今回は直さないなら「I'll leave this as is for now.」、別のPRで対応するなら「I'll handle it in a follow-up PR.」と返します。nitは任意なので、直さないこと自体は失礼ではありません。

nit以外の重要度ラベル

ラベル意味
Nit:小さなこと。直したほうがいいが、影響は大きくない
Optional: / Consider:いい考えだと思うが、必須ではない
FYI:このPRで対応しなくていい。今後の参考に
Blocking:マージ前に必ず対応してほしい(チームによって使う)

Nit・Optional(Consider)・FYIの3つは、Googleのレビューガイドに例として載っているラベルです(Googleのレビューガイド)。

あわせて覚えたい英語の略語

略語意味
LGTMLooks good to me:いいと思います(レビューの承認)
WIPWork in progress:作業中
AFAIKAs far as I know:私の知る限り
TL;DRToo long; didn't read:要約すると
ACKAcknowledged:了解、受け取りました

40の略語をまとめたビジネス・チャットで使う英語の略語一覧もあります。

Devlingoで開発現場の英語を1日10フレーズ

コードレビューやプルリクエストの英語は、Gambit StudioのDevlingo(English for Devs)の「Code Review」「Pull Requests」カテゴリで学べます。全12カテゴリ・3,600以上のフレーズを1日10個ずつ、使う場面と発音ガイド、例文つきで。画面表示は英語などで、日本語には対応していません。

出典

  1. Google Engineering Practices「How to write code review comments」

よくある質問

よく聞かれる質問に、出典つきで答えます。

nit pickとは?
nitpick(ニットピック)は「細かいことにケチをつける」という動詞です。nitpicking は名詞で「あら探し」、nitpicky は形容詞で「細かすぎる」。
nitと書かれた指摘は直さないといけませんか?
必須ではありません。nitは「直すかどうかは任せる」という合図です。直さない場合は一言理由を返すと親切です。
nitの読み方は?
ニットと読みます。
nitはスラングですか?
日常会話では「細かいことにうるさい人」というややくだけた言い方ですが、コードレビューではごく普通に使われる言葉です。

続けて読む

同じアプリのガイドをもっと。手順と出典つき。

Devlingo無料 · iOS 17.0+
インストールなしで使う入手