絶対的にそう!!  TL;DR: 関数名が不明瞭だと、意図がわからなくなり、読者が混乱してしまいます。説明的で、アクション指向の名前を使用してください。 問題点 機能目的が不明瞭 認知負荷の増加 誤解を招く文脈 読みやすさの低下 困難なコラボレーション 隠された機能 ソリューション 行動指向の動詞を使用する わかりやすい を付ける 名前 機能の目的を反映する 一般的な用語を避ける 意味のある文脈を提供する 責任を明確に表現する 行動と結果を一致させる リファクタリング https://hackernoon.com/improving-the-code-one-line-at-a-time コンテクスト 一般的な用語で名前が付けられた関数の場合、読者は関数の動作を理解するために実装の詳細を調べる必要があります。 これにより、時間が無駄になり、エラーが発生する可能性が高まります。 クラス名が追加のコンテキストを提供しないスタンドアロン関数を扱う場合、 さらに重要になります。 命名は この問題は、「 に直接関係しています。 聞くのではなく、伝える」原則 呼び出し元に機能を推測させる曖昧な動作を公開する代わりに、命令型の名前は正確なアクションを伝え、コードを調べることなく読者を導きます。 関数に説明的な名前を付けると、不必要な推測がなくなり、この原則に準拠することになります。 サンプルコード 間違っている public String dateFormatting(Date date) { return new SimpleDateFormat("yyyy-MM-dd").format(date); } public void load() { System.out.println("Loading..."); } 右 public String formatDate(Date date) { return new SimpleDateFormat("yyyy-MM-dd").format(date); } public void loadUserPreferences() { System.out.println("Loading user preferences..."); } 検出 マニュアル [x] この臭いは、   、   、   、  などのあいまいな用語を使用している関数名を確認することで検出できます。 do run process load 自動化されたリンターは、これらのパターンにフラグを立てたり、過度に一般的な名前を持つ関数を強調表示したりできます。 タグ ネーミング レベル 初心者 [x] なぜ一対一変換が重要なのか 関数名は、その名前と機能の間に明確な を作成する必要があります。 1 対 1 の対応 この クションを破ると、開発者はコンテキストのためにコードの詳細を調べる必要があり、デバッグ、レビュー、拡張が遅くなります。 バイジェ  AI生成 AI ツールは、ドメインを理解せずに一般的な関数名を生成することがあります。  AI を使用する場合は、関数名が説明的でアクション指向である必要があることを指定します。  AI検出 AI モデルは、関数シグネチャを事前定義された命名ベストプラクティスと比較することで、あいまいな名前を検出するのに役立ちます。  AI と手動のコードレビューを組み合わせると、最良の結果が得られます。 ぜひお試しください! 覚えておいてください：AIアシスタントは多くの間違いを犯します 適切な指示がなければ 具体的な指示 チャットGPT   チャットGPT   クロード クロード 困惑 困惑 副操縦士 副操縦士 ジェミニ ジェミニ 結論 関数名は単なるラベルではなく、読者との契約です。 この契約を破り、混乱を招きます。 曖昧な名前は 説明的でアクション指向の名前はコミュニケーションを簡素化し、コードの保守と拡張を容易にします。 関係 https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-vii-8dk31x0?embedable=true https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-xxxi?embedable=true   https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-viii-8mn3352?embedable=true https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-xxxv?embedable=true 参照 https://hackernoon.com/what-exactly-is-a-name-the-quest-part-i-fmw3udc?embedable=true   https://hackernoon.com/what-exactly-is-a-name-rehab-part-ii-4st3uph?embedable=true 免責事項 コードスメルは私の です。 意見 クレジット の による写真 Unsplash britishlibrary 関数名は動詞または動詞句で、意味のあるものにする必要があります。 ロバート・C・マーティン https://hackernoon.com/400-thought-provoking-software-engineering-quotes?embedable=true この記事は CodeSmell シリーズの一部です。   https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-i-xqz3evd?embedable=true

This story contains new, firsthand information uncovered by the writer.

Winner of Noonies 2020 for the award Hacker Noon Contributor of the Year - REFACTORING.

2020 - Hacker Noon Contributor of the Year in REFACTORING

2022 - HackerNoon Contributor of the Year - Clean Code

2022 - HackerNoon Contributor of the Year - Debugging

2022 - HackerNoon Contributor of the Year - Github

2022 - HackerNoon Contributor of the Year - Machine Learning

2022 - HackerNoon Contributor of the Year - Quality Assurance

2022 - HackerNoon Contributor of the Year - Refactoring

2022 - HackerNoon Contributor of the Year - Software Architecture

2022 - the Greatest Storyteller

Buy My Book

Share your ideas with me!

Read My Stories

Buy Me a Coffee

Software Engineer and Book Author

このオーディオは、ストーリーの元の言語で制作されています。

長すぎる; 読むには

コードスメル 285 - 非命令型関数の修正方法

コードスメル 285 - 非命令型関数の修正方法

About Author

コメント

ラベル

この記事は

Related Stories

HackerNoon ライティングコンテストで優勝したいですか? #crypto-api コンテスト優勝者のおすすめはこちら

海を航海する: データレイクを使用した本番環境レベルの RAG アプリケーションの開発

HackerNoon Coded: HackerNoonが最も活発に活動している上位10カ国

目に見えない層: ユーザーインタビューがかけがえのない資産である理由

HackerNoon ライティングコンテストで優勝したいですか? #crypto-api コンテスト優勝者のおすすめはこちら

海を航海する: データレイクを使用した本番環境レベルの RAG アプリケーションの開発

HackerNoon Coded: HackerNoonが最も活発に活動している上位10カ国

目に見えない層: ユーザーインタビューがかけがえのない資産である理由

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps