PythonでJSON出力を生成する方法を徹底解説｜jsonモジュールの使い方

Pythonでは標準ライブラリのjsonモジュールを使うことで、辞書（dict）型のデータをそのままJSON形式の文字列に変換（シリアライズ）できます。変換にはjson.dumps()関数を使用します。

基本的な使い方：dictをJSON文字列に変換する

import json

my_dict = {
    'foo': 42,
    'bar': {
        'baz': "Hello",
        'poo': 124.2
    }
}
my_json = json.dumps(my_dict)
print(my_json)

出力結果

このコードを実行すると、次のような出力が得られます。

'{"foo": 42, "bar": {"baz": "Hello", "poo": 124.2}}'

また、json.dumps()にindent引数を渡すことで、インデント付きの読みやすいJSON（pretty print）として出力することも可能です。

indentを使って整形して出力する

import json

my_dict = {
    'foo': 42,
    'bar': {
        'baz': "Hello",
        'poo': 124.2
    }
}
my_json = json.dumps(my_dict, indent=2)
print(my_json)

出力結果

このコードを実行すると、次のように整形された出力が得られます。

{
  "foo": 42,
  "bar": {
    "baz": "Hello",
    "poo": 124.2
  }
}

日本語を含むデータを出力する場合

デフォルト設定では、非ASCII文字（日本語など）はUnicodeエスケープされた状態で出力されます。日本語をそのまま表示したい場合は、ensure_ascii=Falseを指定しましょう。

import json

my_dict = {'name': '太郎'}
print(json.dumps(my_dict, ensure_ascii=False))
# 出力: {"name": "太郎"}

JSONをファイルに保存する場合

JSON文字列として取得するのではなく、ファイルに直接書き込みたい場合は、json.dump()を使用します。dumpsとdumpの違いは、末尾の「s」（string）があるかどうかだけです。

import json

with open('data.json', 'w', encoding='utf-8') as f:
    json.dump(my_dict, f, indent=2, ensure_ascii=False)

このように、Pythonのjsonモジュールを使えば、辞書データから整形済みのJSON出力まで数行のコードで簡単に生成できます。