Pythonのデストラクタメソッド「__del__()」の仕組みと使い方を徹底解説

__del__()メソッドとは

__del__()メソッドは、Pythonにおけるデストラクタ（破壊子）メソッドとして知られる特殊メソッドです。オブジェクトへの参照がすべて削除された後にガベージコレクションが実行される際に呼び出されます。

単純なケースでは、del x のように変数を明示的に削除した直後、あるいは x がローカル変数であれば関数が終了したタイミングで呼び出されます。特に循環参照が存在しない場合、標準のPython実装であるCPythonは即座にガベージコレクションを実行します。

class Sample:
    def __del__(self):
        print("オブジェクトが破棄されました")

obj = Sample()
del obj  # ここで __del__() が呼び出される

実行タイミングは保証されない

Pythonのガベージコレクションについて保証されているのは、「すべての参照が削除された後に実行される」という点だけです。そのため、参照削除の直後に必ず実行されるとは限らず、最終的に一度も実行されない可能性すらあります。

変数が長期間生存するケース

変数が想定よりも長く生き残る理由はいくつもあります。

• 伝播中の例外：例外処理の過程で変数への参照が保持され続けることがある
• モジュールのイントロスペクション：モジュール属性として参照が残ることがある
• 循環参照：オブジェクト同士が互いを参照し合うと、参照カウントが0にならない

特に循環参照については、ガベージコレクションが有効なCPythonでもその大部分を解除できるものの、すべてを解消できるわけではなく、しかも定期的にしか実行されません。

__del__()の有効なユースケース

適切に使えば__del__()にも有用な場面があります。例えば、オブジェクトXがYを参照しており、同時にグローバルキャッシュにもYへの参照のコピーを保持している場合（cache['X -> Y'] = Y）などです。このようなケースでは、X.__del__ 内で対応するキャッシュエントリも一緒に削除してあげると、メモリリークを防ぐことができます。

必要なら明示的に呼び出す

デストラクタが必須の後始末処理（クリーンアップ）を行うことが分かっている場合は、x.__del__() のように明示的に呼び出すことも一つの手段です。ただし、リソースの確実な解放にはコンテキストマネージャ（with文）を使う方が安全なため、状況に応じて使い分けるとよいでしょう。