【ITニュース解説】Python mutable default arguments: why your list keeps growing (tested examples)
2026年10月14日に「Dev.to」が公開したITニュース「Python mutable default arguments: why your list keeps growing (tested examples)」について初心者にもわかりやすく解説しています。
ITニュース概要
Pythonの関数のデフォルト引数にリストなどを使うと、一度しか作られないため、関数呼び出しでリストが共有され意図せぬ変更が起きる。`None`で初期化すれば解決。シャローコピーも注意。
ITニュース解説
Pythonプログラミングの世界へようこそ。システムエンジニアを目指す皆さんが、コードを書く上で遭遇する可能性のある、少し戸惑うかもしれないけれど非常に重要な概念について解説する。今回は、関数のデフォルト引数やオブジェクトのコピーに関するPythonの独特な挙動に焦点を当てる。これらは試験や面接でも頻繁に問われるテーマであり、実際に開発現場でもバグの原因となることがあるため、しっかりと理解しておくことが大切だ。
まず、Pythonの関数のデフォルト引数について見ていこう。関数を定義する際、引数にデフォルト値を設定できる機能は非常に便利だ。例えば、def greet(name="Guest"):のように書けば、greet()と引数なしで呼び出したときにnameは自動的に"Guest"となる。しかし、このデフォルト値にリストや辞書、セットといった「可変(ミュータブル)なオブジェクト」を設定すると、思わぬ挙動をすることがある。
具体例で考えてみよう。以下のような関数add_badを定義したとする。
1def add_bad(x, bucket=[]): 2 bucket.append(x) 3 return bucket
この関数を続けて呼び出してみると、次のような結果になる。
1print(add_bad(1)) # [1] 2print(add_bad(2)) # [1, 2] 3print(add_bad(3)) # [1, 2, 3]
add_bad(1)の結果は[1]で問題ないが、add_bad(2)を呼び出すと[2]ではなく[1, 2]となり、さらにadd_bad(3)では[1, 2, 3]と、リストがどんどん成長していることがわかる。これは多くの初心者が「なぜ?」と感じるポイントだ。通常であれば、関数が呼び出されるたびにbucketという新しい空のリストが作られ、そこに要素が追加されて、関数が終わればそのリストも消える、と考えるかもしれない。
しかし、Pythonのデフォルト引数の動作は少し異なる。bucket=[]というデフォルト値は、関数add_badが「定義されたとき」に一度だけ評価され、そのときに作られた「空のリストオブジェクト」がメモリ上に保持される。そして、その後の関数呼び出しでbucket引数を省略した場合、Pythonはその「一度だけ作られたリストオブジェクト」を常に再利用するのだ。つまり、add_bad(1)、add_bad(2)、add_bad(3)の全てが、同じ一つのリストオブジェクトに対してappend操作を行っているため、リストが成長し続けてしまうというわけだ。この事実は、add_bad.__defaults__という特別な属性を参照することで確認できる。この属性は、デフォルト引数に設定された値のタプルを表示し、関数呼び出し後も([1, 2, 3],)のようにリストが保持されている様子がわかる。
この問題を解決する最も一般的な方法は、デフォルト引数にNoneのような「不変(イミュータブル)なオブジェクト」を使用し、関数の中でリストを初期化することだ。修正後の関数add_okを見てみよう。
1def add_ok(x, bucket=None): 2 if bucket is None: 3 bucket = [] 4 bucket.append(x) 5 return bucket
このadd_ok関数では、bucketのデフォルト値をNoneにしている。関数が呼び出された際、もしbucketに何も渡されずNoneのままならば、if bucket is None:の条件が真となり、そのときに初めてbucket = []として新しい空のリストが作成される。こうすることで、関数が呼び出されるたびに独立した新しいリストが用意されるようになり、期待通りの動作となる。
1print(add_ok(1)) # [1] 2print(add_ok(2)) # [2]
このように、可変なオブジェクト(リスト、辞書、セットなど)をデフォルト引数として使うのは避けるべきだという「クイックルール」を覚えておこう。代わりにNoneを使い、関数内で必要に応じて新しいオブジェクトを生成するのが正しいアプローチだ。
次に、このデフォルト引数の問題と関連して、オブジェクトの「コピー」に関する注意点も見ていこう。Pythonでリストのような複雑なオブジェクトをコピーする際には、「シャローコピー(浅いコピー)」と「ディープコピー(深いコピー)」という違いがある。
例えば、a = [[1, 2], [3, 4]]というリストの中にリストが入っている(ネストされたリスト)場合を考える。b = a.copy()とすることでaのコピーbが作られるが、これはシャローコピーだ。シャローコピーでは、外側のリストは新しく作成されるが、内側のリスト[1, 2]と[3, 4]については、aとbが同じオブジェクトを参照している状態になる。
その結果、b[0].append(99)のようにbの内側のリストを変更すると、print(a)の出力が[[1, 2, 99], [3, 4]]となり、aの内側のリストも変更されてしまう。これは、aとbが同じ内側のリストオブジェクトを共有しているためだ。
もし、ネストされたオブジェクトも含めて完全に独立したコピーを作成したい場合は、copyモジュールのdeepcopy関数を使用する必要がある。c = copy.deepcopy(a)とすると、cはaの完全な独立したコピーとなり、c[0].append(5)のようにcを変更しても、aは全く影響を受けない。
さらに、このシャローコピーの概念は、多次元リスト、特に「グリッド」と呼ばれる2次元のリストを初期化する際にも落とし穴となることがある。例えば、grid = [[0] * 3] * 2のように記述して、2行3列のグリッドを作ろうとすると、意図しない結果を招くことがある。
1grid = [[0] * 3] * 2 2grid[0][0] = 7 3print(grid) # [[7, 0, 0], [7, 0, 0]]
ここでも、grid[0][0]を7に変更したはずが、grid[1][0]も7に変わってしまっている。これは、[0] * 3で作成された内側のリストが、* 2によって「同じ参照」として2回繰り返されているためだ。つまり、gridの1行目と2行目が、実際には全く同じリストオブジェクトを指しているのだ。
この問題の正しい解決策は、リスト内包表記を使うことだ。
1grid2 = [[0] * 3 for _ in range(2)] 2grid2[0][0] = 7 3print(grid2) # [[7, 0, 0], [0, 0, 0]]
[[0] * 3 for _ in range(2)]と書くことで、range(2)が繰り返されるたびに[0] * 3という新しいリストオブジェクトが独立して作成され、それぞれの行が異なるオブジェクトとして確保される。これにより、grid2[0][0]を変更してもgrid2[1][0]には影響が出ず、期待通りの動作となる。
まとめると、Pythonプログラミングにおいて特に注意すべき点は以下の三つだ。
第一に、リスト、辞書、セットといった可変なオブジェクトを関数のデフォルト引数として使わない。代わりにNoneを使い、関数内で条件分岐によって新しいオブジェクトを作成する。
第二に、ネストされたデータ構造のコピーが必要な場合は、list.copy()やスライシングのようなシャローコピーではなく、copy.deepcopyを使ってディープコピーを作成する。
第三に、多次元リスト、特にグリッドを初期化する際には、*演算子による繰り返しではなく、リスト内包表記を積極的に使用する。
これらの挙動は、Pythonがオブジェクトをどのように扱っているかを理解する上で非常に重要だ。コードの出力を事前に予測する習慣を身につけることで、これらの罠にはまることを避け、より堅牢なプログラムを作成できるようになるだろう。システムエンジニアを目指す皆さんにとって、この知識はきっと役立つはずだ。