JavaScriptのコーディング規約（JavaScript Coding Conventions）とは？読みやすいコードを書くための基本ルール
生徒
「JavaScriptのコードって、人によって書き方がバラバラに見えるんですけど、正しい書き方ってあるんですか？」
先生
「とても良い観点ですね。JavaScriptには“コーディング規約”という決まりごとがあります。それを守ることで、読みやすくてミスが少ないコードを書くことができるんです。」
生徒
「なるほど、書き方にルールがあるんですね！どんなルールがあるのか教えてください！」
先生
「よし、今回はJavaScriptのコーディング規約の基本を一緒に見ていきましょう！」
1. コーディング規約（Coding Conventions）とは？
コーディング規約とは、コードを書くときのルールやマナーのことです。プログラミングでは、コンピューターが動けば正しいコードに見えるかもしれませんが、人間が見て理解しやすいこともとても重要です。
例えば、誰かが書いたコードを他の人が読みやすくするためには、見た目を整えることやわかりやすい名前をつけることが大切です。
2. インデント（字下げ）をそろえよう
インデントとは、コードの左側にスペースやタブで空けることです。これにより、コードの構造がひと目でわかりやすくなります。
function greet(name) {
if (name) {
console.log("こんにちは、" + name + "さん！");
}
}
このように、if文の中身を少し右に下げて書くことで、このコードが「if文の中にある」ということが明確になります。
3. セミコロンを使おう
JavaScriptでは、文の終わりにセミコロン（;）をつけるのが一般的です。なくても動くこともありますが、予期しないバグを防ぐために、基本的にはつけるようにしましょう。
let message = "おはようございます";
console.log(message);
4. わかりやすい変数名を使おう
変数名は、短すぎず・長すぎず・意味のある名前にしましょう。たとえば、「a」や「b」のような名前より、「userName」や「itemCount」のように、その変数が何を表しているのかが伝わる名前が良いです。
// 悪い例
let a = "太郎";
// 良い例
let userName = "太郎";
5. 一貫した書き方をする
書き方は人によってさまざまですが、同じファイルの中でスタイルをそろえることが大切です。たとえば、ダブルクォーテーション（"）とシングルクォーテーション（'）は、どちらでも使えますが、どちらかに統一しましょう。
// 統一されていない書き方
let name = "花子";
let greeting = 'こんにちは';
// 統一された書き方（どちらでもOK）
let name = "花子";
let greeting = "こんにちは";
6. コメントを使って説明しよう
コメントは、コードの中に説明を書くためのものです。実行には影響しません。あとから自分が見返すときや、他の人に分かりやすく伝えるためにとても大切です。
// これはあいさつメッセージを表示する関数です
function sayHello() {
console.log("こんにちは！");
}
7. 空行やスペースで見た目を整えよう
コードがギュウギュウに詰まっていると読みづらくなります。関係のある処理ごとに空行を入れることで、読む人の頭が整理しやすくなります。
let userName = "ゆうき";
let greeting = "こんにちは、" + userName + "さん！";
console.log(greeting);
8. 小文字とキャメルケースに気をつけよう
JavaScriptでは、変数や関数の名前は小文字から始めて、単語の区切りを大文字にする「キャメルケース」が一般的です。
// キャメルケースの例
let userAge = 20;
function getUserAge() {
return userAge;
}
最初の文字が小文字で、単語の区切りだけ大文字にすることで、見た目が整って読みやすくなります。
9. コーディング規約は「他の人のための思いやり」
コードを書くときにコーディング規約を守ることは、自分のためでもあり、他の人のためでもあります。誰かが後からコードを見たときに、「読みやすいな」と感じてもらえるのが理想です。
たとえるならば、ノートを丁寧に書くことと同じです。自分だけがわかればいいノートよりも、誰が見ても理解しやすいノートの方が親切ですよね。
まとめ
これまでJavaScriptのコーディング規約について学んできました。コーディング規約とは、コードを書くときのルールやマナーのことで、読みやすく、保守しやすいプログラムを書くために非常に重要です。初心者でも、まずはインデントをそろえること、セミコロンを正しくつけること、変数や関数にわかりやすい名前をつけることから始めると良いでしょう。インデントをそろえることでコードの構造がひと目でわかり、セミコロンを付けることで予期しないエラーを防ぐことができます。さらに、変数名や関数名を意味のある名前にすることで、他の人がコードを読んだときに理解しやすくなります。
また、一貫した書き方を守ることも重要です。クォーテーションの統一やキャメルケースの使用、空行やスペースでコードの見た目を整えることで、コード全体が整然とし、読みやすさが向上します。コメントを適切に書くことも忘れずに、処理内容や意図を説明することで、自分や他の人が後からコードを理解しやすくなります。これらのポイントを意識することで、初心者でも読みやすく、保守性の高いJavaScriptコードを書くことができます。
サンプルプログラム
// あいさつメッセージを表示する関数
function greetUser(userName) {
if (userName) {
console.log("こんにちは、" + userName + "さん！");
}
}
let userName = "太郎";
greetUser(userName);
このサンプルでは、インデント、セミコロン、わかりやすい変数名、コメントの使い方が守られています。これにより、コードが整理され、誰が見ても理解しやすくなります。
生徒
「今日のまとめを見ると、JavaScriptのコーディング規約を守るとコードがとても読みやすくなることがわかりました。特にインデントや変数名、コメントの重要性が理解できました。」
先生
「その通りです。初心者のうちは動くコードを書くことが先ですが、慣れてくると読みやすく整ったコードを書くことも大切です。インデントや空行、セミコロン、わかりやすい変数名や関数名を意識することで、将来的に保守性の高いコードを書く力が身につきます。」
生徒
「コメントや空行の使い方も、コードを他の人や自分が後から読んだときに役立つんですね。単に動けばいいだけじゃなくて、見やすさや整理整頓も重要なんですね。」
先生
「そうです。特にチームで開発するときや大きなプロジェクトでは、コーディング規約を守ることが品質の向上やエラーの防止につながります。まずは今日学んだ基本を意識して、サンプルプログラムのように実践してみましょう。」
生徒
「わかりました！これからは読みやすく整ったコードを書くことを意識して学んでいきます！」
この記事を読んだ人からの質問
