Pythonの辞書（dict）を文字列に変換する方法｜JSONによるシリアライズと復元の基本

辞書を文字列化するならJSONがベスト

Pythonの辞書（dict）を文字列として保存・送信したい場合、最も推奨される形式はJSONです。標準ライブラリのjsonモジュールを使えば、追加インストール不要で簡単に相互変換が行えます。

• json.dumps(dict) … 辞書 → 文字列（シリアライズ）
• json.loads(string) … 文字列 → 辞書（デシリアライズ）

基本的な使い方

例えば、次のように辞書を文字列へ変換し、再び元の辞書へ戻すことができます。

>>> import json
>>> d = {'id': 15, 'name': 'John'}
>>> x = json.dumps(d)
>>> print(x)
{"id": 15, "name": "John"}
>>> print(json.loads(x))
{'id': 15, 'name': 'John'}

dumps()で文字列化したデータは、loads()を通すことで完全に元の辞書構造へ復元されます。これが最もシンプルで高速な方法です。

覚えておくと便利なオプション

日本語を含む辞書を扱う場合

デフォルトでは非ASCII文字がUnicodeエスケープされます。日本語をそのまま出力したいときはensure_ascii=Falseを指定しましょう。

>>> d = {'name': '太郎'}
>>> json.dumps(d)
'{"name": "\\u592a\\u90ce"}'
>>> json.dumps(d, ensure_ascii=False)
'{"name": "太郎"}'

整形して読みやすく出力する

indent引数を指定すると、インデント付きの整形されたJSONが出力され、ログや設定ファイルの確認に役立ちます。

>>> print(json.dumps(d, indent=4))
{
    "id": 15,
    "name": "John"
}

まとめ

Pythonの辞書をシリアライズ・デシリアライズするには、json.dumps()とjson.loads()の組み合わせが最も簡単かつ確実です。設定ファイルの保存やAPIとのデータ通信など、実務でも頻繁に使われるテクニックなので、ぜひマスターしておきましょう。