【プログラミング】メソッド名や関数名などを英語で命名する際に参考にしているQiitaの記事5選

エンジニアとしてプログラミングをする際、悩む問題の一つとしてメソッド名や関数名、クラス名などの命名規則があります。

僕はあまり英語が得意でなく、文法的に問題ないか？ネイティブが使うような感覚で英語での命名が出来ているか？がいまいち自信を持てずにいます。

良いコードの性質の一つに、コードを読めば意図を理解でき、よほどのことがない限りコメントが不要というものがあると考えています。

上記を満たすためには、適切なクラス設計と英語での命名規則が重要となります。

英語に自信がないと困りますね。

そんな僕がQiitaで見つけ、実際に参考にしている記事を5つご紹介します。

モデルやメソッドに名前を付けるときは英語の品詞に気をつけよう

「プロを目指す人のためのRuby入門」の著者でもある伊藤淳一さんの記事です。

モデルやメソッドごとで命名規則を説明していたり、ケースバイケースで詳細に英語の使い分けが記述されておりとても参考になる記事です。

エンジニアなら読んでおきたい記事の一つになりそうですね。

余談ですが、この方にはRSpecの書き方などかなりお世話になっており圧倒的感謝です。

こちらに記載されている英単語でかなりのメソッドやモデル名の単語を網羅できるのではないでしょうか？

また、以下のようなシリーズごとにまとめられており、大変便利ですね。

略語なども多くまとめられているので、初心者にありがちな大体略される英単語を長々と書いてしまう問題の対策にもなります。

こちらはメソッドに特化した記事となります。

プログラミングといえばメソッドのコレクションのようなイメージがあるので、本当によく参考にさせて貰ってます。

メソッドは原則、一つのことのみを行うことを念頭にコーディングしていくと「あれ？これどういう名前にしよう？」という状況がまあまああります。

そんな時、この記事を参考に「この動詞が合うかも？」と見つけ出すことができます。

こちらの記事はメソッド名などとは違い、gitのコミットメッセージでの頻出動詞と単語をGithubの人気のリポジトリから抽出したものとなります。

モダンな開発環境では基本的にgitでバージョン管理をするのが主流だと思います。

一つの作業粒度でコミットする際に英語でどういった変更を加えたのが正しく表記しないと「git log」などでコミットを一覧で確認する時に「これは何を変更したコミットなの？」が正しく理解出来ず、結局コミットの変更差分を見て理解するという手間が発生してしまいます。

英語で正しく表記し、gitのコミットを一目でどういった変更があったか確認できるようにしましょう。

こちらの記事もgitのコミットメッセージに関するものですね。

筆者の方はシリコンバレーで英語ネイティブの方と実際に働いて同僚が行ったコミットのメッセージから頻出しているものを紹介してくれています。

かなり実用的です。

以上で、メソッド名や関数名などを英語で命名する際に参考にしているQiitaの記事の紹介を終わります。

本当に参考にしていたので有用だと思います。

最近はコードを書く作業から少し離れていますが、また時間を見つけて自分の作りたいサービスを気の赴くままに開発するという最高の贅沢をしたいですね。

疎結合に、可読性、保守性の高い綺麗なコードがかけると楽しいものです。

英語が苦手な方、ぜひこの記事を参考に命名の楽しさを広げていただけたらと思います。