コーディング規約（Coding Standard）

コーディング規約（Coding Standard）とは、プログラムのコードを書く際に、書き方をあらかじめ統一するために定められたルール集のことです。変数名の付け方やインデントの取り方など、細かな書き方の決まりごとをチームであらかじめ共有しておくために使われます。

現実世界に例えると、コーディング規約は複数人で分担して作る料理のレシピの共通ルールのようなものです。「塩は小さじ1」「切り方はこう」といった細かい決まりをそろえておくことで、誰が作っても同じような仕上がりになります。

コーディング規約図解

※画像をクリックすると拡大表示します。

プログラムは動けばそれで良いというわけではなく、後から読む人（自分自身を含む）にとって、理解しやすい書き方になっているかが非常に重要です。書き方がバラバラだと、修正や機能追加のたびに余計な時間がかかってしまいます。

広く知られているものとして、GoogleやAirbnbなどの企業が公開している言語別のスタイルガイドがあります。これらを自社独自にアレンジして採用したり、そのまま社内標準として取り入れたりする企業も多く見られます。

複数人で同じプログラムを作るチーム開発では、コーディング規約が無いと、担当者ごとに書き方がバラバラになり、コード全体の統一感が失われてしまいます。規約に沿って書くことで、誰が書いたコードでも一定の品質と読みやすさが保たれます。

近年は、コーディング規約に沿っているかどうかを自動でチェックする「静的解析ツール」を導入するチームも増えています。人の目でのチェックに頼らず、規約違反を機械的に検出できるため、レビューの手間を減らしながら品質を保てます。

規約を無視した書き方が積み重なると、コードの見通しが悪くなり、バグの発見が遅れたり、修正時に思わぬ影響が出たりするリスクが高まります。一見些細なルール違反でも、積み重なることでチーム全体の生産性を下げる原因になります。

規約は厳しすぎても形骸化しやすいため、チームの実情に合わせて、本当に重要なルールに絞って定めることが長続きのコツです。既存の有名なスタイルガイドをベースに、自チームに合わせて微調整する方法もよく取られています。

コーディング規約の細かな内容は、プログラミング言語ごとの慣習によっても変わってきます。ある言語では当たり前とされる書き方が、別の言語ではあまり好まれないこともあり、使用する言語のコミュニティで一般的とされる書き方を踏まえて規約を作ることも大切です。