ホームページ > バックエンド開発 > Python チュートリアル > プログラミングにおける命名術: 良い名前が重要な理由!

プログラミングにおける命名術: 良い名前が重要な理由!

Mary-Kate Olsen
リリース: 2024-12-24 14:53:13
オリジナル
632 人が閲覧しました

The Art of Naming in Programming: Why Good Names Matter!

プログラマーの皆さん、こんにちは!私たち全員が行っていることですが、めったに考えないこと、つまりコードに名前を付けることについて話しましょう。

名前がコードの第一印象となる理由

すべてのものに「物 1」、「物 2」、「物 3」というラベルが付けられている部屋に入ると想像してください。混乱しますよね?他の開発者にとって、コード名はまさにそのように感じられます。

これはひどい例です:

def f(x, y):
    return x * y
ログイン後にコピー

今度は、より良いバージョンです:

def calculate_rectangle_area(length, width):
    return length * width
ログイン後にコピー

違いがわかりますか? 2 番目のバージョンでは、何が起こっているかを正確に示します。

意図を明らかにすることが重要

良い名前は 3 つの重要な質問に答えます:

  • これは何をするのですか?
  • それはなぜ存在するのですか?
  • どのように使用されますか?

実際の例を見てみましょう:

# Bad: Unclear purpose
def process(data):
    result = []
    for item in data:
        if item > 0:
            result.append(item)
    return result

# Better: Clear and intentional
def filter_positive_numbers(number_list):
    return [number for number in number_list if number > 0]
ログイン後にコピー

ネーミングの落とし穴を回避する

避けるべきよくある間違い:

  1. 難解な略語:
# Avoid
usr_cnt = len(users)

# Prefer
user_count = len(users)
ログイン後にコピー
  1. 意味のないバリエーション:
# Confusing
def get_user_info()
def get_user_data()
def get_user_details()

# Clear
def get_user_profile()
ログイン後にコピー
  1. 単一文字の名前:
# Bad
def calc(x, y, z):
    return x * y / z

# Good
def calculate_average_rate(total_revenue, total_hours, number_of_projects):
    return total_revenue / (total_hours * number_of_projects)
ログイン後にコピー

実用的な命名ガイドライン

  • クラス: 名詞を使用します
  • 関数: 動詞を使用します
  • 変数: 具体的にする
  • 定数: すべて大文字
# Great naming example
class CustomerAccount:
    MAX_WITHDRAWAL_LIMIT = 5000

    def calculate_monthly_interest(self, balance):
        return balance * 0.05
ログイン後にコピー

コンテキストは王様です

名前は環境の中で意味をなすものでなければなりません。状態のような変数はあらゆる意味を持ちます。ただし、customer_state または order_processing_state は非常に明確です。

# Unclear
def update(state):
    pass

# Clear
def update_order_processing_state(order_status):
    pass
ログイン後にコピー

黄金律

  1. 一貫性を保つ
  2. 説明的であること
  3. シンプルにしてください
  4. 次の開発者 (おそらく将来のあなた!) について考えてみましょう

最終的な考え

ネーミングは単に単語を入力するだけではありません。それはコミュニケーションです。コードでストーリーを伝えているのです。他の人が読みたくなるような物語にしましょう。

未来のあなたはあなたに感謝するでしょう。チームメイトはあなたに感謝するでしょう。なんと、あなたのコンピュータでも仮想ハイタッチをしてくれるかもしれません✋。

以上がプログラミングにおける命名術: 良い名前が重要な理由!の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

ソース:dev.to
このウェブサイトの声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。
著者別の最新記事
人気のチュートリアル
詳細>
最新のダウンロード
詳細>
ウェブエフェクト
公式サイト
サイト素材
フロントエンドテンプレート