2025.11.19

読みやすいコーディング

この記事を書いたチーム：frontier

はじめに

読みやすいコーディングにおいて一番大事なことは、

「他人が理解しやすいように書く」ことだと思います。

コードは書いた瞬間だけでなく、後から読む人（未来の自分を含む）が理解できて初めて価値があります。どんなに高度なアルゴリズムでも、読みにくければバグの潜在要因になり、保守や改修に時間がかかります。

この「他人が理解しやすいように書く」という意識が、命名、コメント、構造、関数設計などすべての判断の軸になります。

変数名を、xやiなど何に使用しているか分かりづらいものにせず、priceやtellNoなど、変数名を見れば何に使用しているのか分かるものを使いましょう。

この処理は何をしているのか？なぜこの処理が必要か？を意識して、適切にコメントを残すようにしましょう。

インデントを正しく使い、ネストが深くなりすぎないように注意しましょう。

処理のまとまりごとに空行を入れることで、視覚的に読みやすくなります。

また、1行の長さは80〜120文字程度に抑えると、横スクロールの必要がなくなり、可読性が向上します。

1度書いたコードは少し時間をおいて自分で見直すことで、改善点が見えてきます。他人のレビューを受けることで、自分では気づけなかった問題点を発見できることもあります。また、他人の書いたコードを読むことで、自分のコードとの違いを考えることも重要です。

上記にいくつかポイントを記述しましたが、技術的なテクニックよりも、読む人への思いやりが重要になります。コーディングをする際、読む人への思いやりを意識してみるとより良いコーディングができると思います。