Pythonの@演算子（デコレータ）とは？仕組みと使い方をわかりやすく解説

Pythonにおける@演算子の役割

Pythonでは、@記号はデコレータを定義するために使用されます。デコレータは、高階関数を呼び出すためのシンプルで読みやすい構文を提供します。定義上、デコレータとは「別の関数を受け取り、その関数本体を明示的に変更することなく、元の関数の振る舞いを拡張する関数」のことです。

デコレータの2つの種類

Pythonのデコレータには、主に以下の2種類があります。

• 関数デコレータ（Function Decorators） — 関数に対して適用される
• クラスデコレータ（Class Decorators） — クラスに対して適用される

デコレータの基本的な仕組み

Pythonにおけるデコレータは、関数やクラスを修飾（変更）する目的で使われる、あらゆる呼び出し可能（callable）なPythonオブジェクトです。関数またはクラスへの参照がデコレータに渡されると、デコレータは変更済みの関数やクラスを返します。この変更された関数やクラスには、通常、元の関数を呼び出す処理が内部に含まれています。

デコレータの基本構文は次のとおりです。

@decorator
def f(argument):
    ...

この記述により、関数 f は decorator(f) で置き換えられます。つまり、その後に f(argument) を呼び出すことは、decorator(f)(argument) を呼び出すことと完全に同等になるのです。

具体的な使用例

実際によく使われるのが、処理時間の計測やログ出力などの共通機能を複数の関数に付加するパターンです。以下は、関数の実行時間を計測するシンプルなデコレータの例です。

import functools
import time

def timer(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        start = time.perf_counter()
        result = func(*args, **kwargs)
        end = time.perf_counter()
        print(f"{func.__name__} の実行時間: {end - start:.4f}秒")
        return result
    return wrapper

@timer
def slow_function():
    time.sleep(1)

slow_function()
# 出力例: slow_function の実行時間: 1.0012秒

このように@演算子を使うことで、関数の本体コードを汚さずに、再利用性の高い形で機能を追加できます。標準ライブラリにも functools.lru_cache や staticmethod、classmethod など、便利なデコレータが多数用意されています。