PythonのタプルをJSON形式で表現する方法と注意点

JSONフォーマットには「タプル」という概念が存在しません。そのため、Pythonの標準ライブラリであるjsonモジュールを使ってタプルをJSONに変換すると、タプルは自動的にJSONの配列（リスト）として出力されます。これは、JSONにおいてタプルに最も近いデータ構造が配列だからです。

タプルをJSONに変換すると何が起こるか

重要なポイントは、タプル特有の「イミュータブル（変更不可）」という性質は、変換後には保持されないということです。JSON側から見れば、タプルもリストも同じ配列であり、両者を区別する情報は失われます。つまり、一度JSONに変換してしまうと、元のデータがタプルだったのかリストだったのかを判別することはできません。

イミュータブル性を保ちたい場合の対処法

1. pickleモジュールを使用する

Pythonのオブジェクト構造（型情報を含む）をそのまま保存したい場合は、pickleモジュールが便利です。ただし、pickleはPython独自のシリアライズ形式であり、データは.jsonファイルではなく.pklファイルに保存されます。

この点には注意が必要です。pickle形式はPython以外の環境では基本的に読み取れず、Web APIなどインターネット経由でデータを送受信する用途には適していません。また、セキュリティ上のリスクもあるため、信頼できないソースからのpickleデータの読み込みは避けるべきです。

2. 独自のエンコーダー・デコーダーを作成する

最も柔軟な方法は、リストとタプルを区別できる独自のエンコーダー・デコーダーを実装することです。例えば、タプルを「{"type": "tuple", "value": [...]}」のようなマーカー付きのJSONオブジェクトに変換しておけば、デコード時に元の型を正確に復元できます。

このアプローチなら、JSON形式のままデータをやり取りしつつ、必要に応じてタプルとリストを区別して復元することが可能になります。実装の自由度が高く、WebアプリケーションやAPIでのデータ交換にも対応できるのが大きなメリットです。

まとめ

JSONにはタプルの概念がないため、jsonモジュールによる変換ではタプルは配列になり、イミュータブル性は失われます。
型情報ごと保存したい場合はpickleが有効ですが、.pkl形式となりWeb送信には不向きです。
Webでのデータ交換を前提とするなら、リストとタプルを区別できる独自のエンコーダー・デコーダーを作成するのがベストな選択肢となります。