コードの匂い - 言語の混乱

複雑すぎる名前は混乱を招く

TL;DR: ネーミングは難しいものです。不必要に複雑にして複雑にしないでください。

問題点

• 不明瞭、誤解を招く、漠然とした曖昧な名前

• 冗長な用語

• 紛らわしい抽象化

• 難解な略語

ソリューション

1. 命名規則を簡略化します

2. 一貫性を確保する

3. 不必要な専門用語を避ける

4. 動作に基づいてわかりやすい名前を使用します

5. 用語の一貫性を維持する

コンテクスト

ルートヴィヒ・ウィトゲンシュタインは、多くの混乱は言語の誤用から生じると主張しました。

これは、名前を複雑にしすぎたり、比喩を混ぜたり、一貫性のない用語を使用したりした場合に発生します。

クラス、メソッド、または変数に明確に名前を付けると、他の人がナビゲートするのに苦労する言語迷路が作成されます。

これによりバグが発生し、メンテナンスが困難になり、チームのフラストレーションにつながります。

サンプルコード

間違っている

public class AbstractDataHandlerManager {
    private String dtStr;

    public void execProcessingOps(String input) {
        if (dtStr != null && !dtStr.isEmpty()) {
            // process
        }
    }
}

右

public class SETIProcessor {

    public void processSignal(String input) {      
            // process
        }
    }
}

検出

[X] マニュアル

名前が長くなり始めた場合、または「Abstract」、「Manager」、「Handler」、「Helper」、または「Data」が頻繁に表示される場合に、この臭いを検出できます。

もう 1 つの兆候は、コード レビューなどで名前の意味を他の開発者に説明しなければならない場合です。

タグ

• 命名

レベル

[X] 初心者

AIの生成

AI ジェネレーターは、考えられるすべてのコンテキストをカバーしようとする冗長で一般的な名前を生成することによって、この匂いを作成することがよくあります。

彼らは多くの分野の専門家であり、コードを作成しますが、指示がない限り、両方を同時に行うことはよくありません。

AI検出

AI ジェネレーターは、「名前を単純化する」や「冗長な用語を削除する」などの単純なリファクタリング命令でこの問題を解決できる場合がありますが、より深い文脈の理解には苦労します。

結論

コード内の言語的な混乱は、不必要な複雑さにつながります。

コードを読みやすく、保守しやすくするために、明確で一貫性のあるわかりやすい名前を使用します。

関係

コードの匂い 22 - ヘルパー

マキシ・コンティエリ ・ 2020年11月12日

#おっと #ヘルパー #コード初心者 #初心者

コードの匂い 38 - 抽象的な名前

マキシ・コンティエリ ・ 2020年11月30日

#おっと #コード初心者 ＃ネーミング #webdev

コードの匂い 197 - 無償のコンテキスト

マキシ・コンティエリ ・ 2023年2月21日

#webdev #初心者 ＃プログラミング ＃チュートリアル

コードの匂い 113 - データの命名

Maxi Contieri ・ 2022 年 1 月 5 日

#おっと #webdev #データベース #リファクタリング

詳細情報

ウィトゲンシュタインの言語混乱の概念

ソフトウェア（の間違い）とは何ですか

Maxi Contieri ・ 2020年10月8日

#おっと ＃固体 #初心者 ＃デザイン

名前とは正確には何ですか? — パート I: クエスト

Maxi Contieri ・ 2021年2月9日

#コード初心者 ＃チュートリアル #webdev #おっと

名前とは正確には何ですか - パート II リハビリ

Maxi Contieri ・ 2021 年 5 月 23 日

＃チュートリアル #コード初心者 ＃プログラミング #webdev

免責事項

コードの匂いは私の意見です。

クレジット

Unsplash の Mimi Tian による写真

---

明確な言葉の最大の敵は不誠実です。

ジョージ・オーウェル

ソフトウェア エンジニアリングの素晴らしい名言

Maxi Contieri ・ 2020年12月28日

#コード初心者 ＃プログラミング #引用符 ＃ソフトウェア

---

この記事は CodeSmell シリーズの一部です。

コードの怪しい部分を見つける方法

マキシ・コンティエリ ・ 2021年5月21日

#コード初心者 ＃チュートリアル #コード品質 #初心者

以上がコードの匂い - 言語の混乱の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。