未経験からエンジニアとして転職した筆者の備忘録、また知識の整理のため記事を書きます。 今回は入社してこれまで幾度となくご指摘いただいてきた命名について、アドバイスいただいたこと、本を読んで得たことをまとめます。 命名が大切な理由 意図や目的を表現した命名をすることで、コードの理解がスムーズになります。 チームのメンバーはもちろん、数ヶ月後の自分が再度コードを読む時にも可読性が上がります。 この記事を書くにあたりプログラミングを学び始めのころの自分のコードを見てみましたが、以下のNGパターンのオンパレードで読むのが大変でした。。 命名NGパターン 意図がわからない名前は避ける 技術駆動命名 プログラミング用語やコンピューター用語(例: Int, Memory, Flag)に基づいた命名。意図が伝わりにくい 連番命名 例: user1, user2 のように番号で区別。中身の違いが伝わらない。