Python
PR

PythonでJSONを扱う方法|json.loads・dumpsの使い方とエラー対処

PythonでJSONを扱う方法|json.loads・dumpsの使い方とエラー対処
hr
記事内に商品プロモーションを含む場合があります

Web API から受け取ったデータや、設定ファイルの多くは JSON という形式で書かれています。Python では、最初から入っている json モジュールを使うと、追加のインストールなしで JSON を読み書きできます。

この記事では、json モジュールの 4 つの関数の使い分けと、つまずきやすい「日本語が \u7530\u4e2d のようになる」「文字化けする」「datetime を変換できない」「JSONDecodeError が読めない」の直し方を説明します。載せている出力は、Windows 11・Python 3.12.6 で実際に実行して確かめたものです。

JSON そのものの書き方(使える値の種類や、よくある書き間違い)は、JSON 整形ツールのページで解説しています。

json モジュールの 4 つの関数

json モジュールでよく使う関数は 4 つです。名前の最後に s が付くものは文字列(string)を、付かないものはファイルを相手にします。

関数やること入力出力
json.loads(文字列)JSON を読み込むJSON の文字列dict や list など
json.dumps(データ)JSON に書き出すdict や list などJSON の文字列
json.load(ファイル)JSON ファイルを読み込むopen() で開いたファイルdict や list など
json.dump(データ, ファイル)JSON ファイルに書き出すdict や list などファイルに書き込む

JSON の文字列を読み込む:json.loads

json.loads に JSON の文字列を渡すと、Python の dict(辞書)や list(リスト)が返ってきます。次のコードを sample.py という名前で保存します。

import json

text = '{"name": "田中", "age": 25, "skills": ["Python", "SQL"], "active": true, "manager": null}'
data = json.loads(text)

print(data)
print(type(data))
print(data["name"], data["skills"][0])
print(type(data["active"]), data["manager"])

PowerShell で、sample.py を保存したフォルダーに移動してから実行します。

py sample.py
{'name': '田中', 'age': 25, 'skills': ['Python', 'SQL'], 'active': True, 'manager': None}
<class 'dict'>
田中 Python
<class 'bool'> None

JSON の true は Python の True に、null は None に変わっています。読み込んだ後は普通の dict なので、data["name"] のようにキーで値を取り出せます。

キーがないかもしれないときは get を使う

API の応答などでは、データによってキーがあったりなかったりします。data["age"] の書き方では、キーがないと KeyError で止まります。get を使うと、キーがないときは None(または指定した値)が返ります。

import json

users = json.loads('[{"id": 1, "name": "田中", "age": 25}, {"id": 2, "name": "佐藤"}]')
for u in users:
    print(u["id"], u["name"], u.get("age"), u.get("age", "不明"))

users[1]["age"]
1 田中 25 25
2 佐藤 None 不明
Traceback (most recent call last):
  ...
KeyError: 'age'

Python のデータを JSON の文字列にする:json.dumps

json.dumps は、dict や list を JSON の文字列に変えます。何も指定しないと、次のように 1 行で出力され、日本語は \u7530\u4e2d のような形になります。

import json

data = {"name": "田中", "age": 25, "skills": ["Python", "SQL"], "active": True, "manager": None}
print(json.dumps(data))
{"name": "\u7530\u4e2d", "age": 25, "skills": ["Python", "SQL"], "active": true, "manager": null}

日本語をそのまま出す:ensure_ascii=False

\u7530\u4e2d は文字化けではなく、「田」「中」を文字の番号(Unicode のコードポイント)で書いた JSON の正しい書き方です。読み込めば「田中」に戻ります。ただ、人が読むには不便です。

これは、ensure_ascii という引数の初期値が True になっているためです。Python の公式ドキュメントでは「True(初期値)のとき、ASCII 以外の文字はすべてエスケープされる。False のときはそのまま出力される」と説明されています。ASCII は半角の英数字と記号のことで、日本語は ASCII 以外の文字です。上のコードの print を次のように変えると、日本語がそのまま出力されます(以降の例も、同じ data を使います)。

print(json.dumps(data, ensure_ascii=False))
{"name": "田中", "age": 25, "skills": ["Python", "SQL"], "active": true, "manager": null}

見やすく改行する:indent

indent に数字を指定すると、その数の半角スペースで字下げして改行します。

print(json.dumps(data, ensure_ascii=False, indent=2))
{
  "name": "田中",
  "age": 25,
  "skills": [
    "Python",
    "SQL"
  ],
  "active": true,
  "manager": null
}

indent="\t" とするとタブで字下げします。indent=0 は「字下げなしで改行だけ入れる」という意味になり、1 行にはなりません。1 行にしたいときは indent を指定しない(初期値の None のまま)にします。

キーを並べ替える:sort_keys

何も指定しないと、キーは dict に入れた順番のまま出力されます。sort_keys=True にすると、キーを並べ替えて出力します。入れ子になった dict の中も並べ替えられます。

print(json.dumps({"b": 1, "a": 2, "c": {"z": 0, "y": 1}}, sort_keys=True))
{"a": 2, "b": 1, "c": {"y": 1, "z": 0}}

並び順は文字コード順で、Zip・age・名前 なら「大文字 → 小文字 → 日本語」の順になりました。毎回同じ順番になるので、2 つの JSON を見比べるときに便利です。

手元にある JSON をさっと整形・圧縮したいだけなら、コードを書かなくても JSON 整形ツールに貼り付ければ同じことができます。

Python と JSON の型の対応表

Python の公式ドキュメント(json モジュール)に載っている変換の対応は、次のとおりです。読み込むとき(JSON → Python)と書き出すとき(Python → JSON)で、少しだけ違います。

JSON読み込むと(JSON → Python)書き出せる Python の型(Python → JSON)
object({ })dictdict
array([ ])listlist、tuple
stringstrstr
number(整数)intint、float、int・float を元にした Enum
number(小数)float(同上)
true / falseTrue / FalseTrue / False
nullNoneNone

この表から、次のような「行って戻ってくると変わる」ことが起きます。実際に試した結果です。

  • tuple は list になる:json.dumps((1, 2)) は [1, 2] になり、読み込むと list で戻ってきます。
  • dict のキーは文字列になる:JSON のキーは必ず文字列なので、json.dumps({1: "x"}) は {"1": "x"} になり、読み込むと {'1': 'x'}(キーが文字列の “1”)になります。None のキーは "null" になります。公式ドキュメントにも、キーが文字列でない dict は loads(dumps(x)) != x になると書かれています。
  • 小数点や指数があれば float になる:json.loads('3.0') は 3.0(float)、json.loads('1e2') も float です。整数の 10 は int になります。
  • NaN と Infinity は JSON の規格外:json.dumps(float("nan")) は NaN を出力しますが、これは JSON の仕様にない値で、ほかのプログラムでは読めないことがあります。規格どおりにしたいときは allow_nan=False を付けると、ValueError で止まるようになります。

表にない型(datetime、set、Decimal、自分で作ったクラスなど)は、そのままでは JSON にできません。対処方法は後の「datetime などを変換できない」で説明します。

JSON ファイルを読み書きする:json.load・json.dump

ファイルを扱うときは、open() でファイルを開いてから、そのファイルを json.load・json.dump に渡します。open() には必ず encoding="utf-8" を付けます(理由は次の見出しで説明します)。

次は、settings.json があれば読み込み、なければ初期値を使い、count を 1 増やして保存する例です。config.py として保存します。

import json
from pathlib import Path

path = Path("settings.json")

if path.exists():
    with path.open(encoding="utf-8") as f:
        settings = json.load(f)
else:
    settings = {"user": "田中", "theme": "light", "count": 0}

settings["count"] += 1

with path.open("w", encoding="utf-8") as f:
    json.dump(settings, f, ensure_ascii=False, indent=2)

print(settings)
py config.py

2 回実行すると、次のように count が増えていきます。

{'user': '田中', 'theme': 'light', 'count': 1}
{'user': '田中', 'theme': 'light', 'count': 2}

保存された settings.json の中身は次のとおりです。json.dump にも json.dumps と同じ ensure_ascii・indent・sort_keys を指定できます。

{
  "user": "田中",
  "theme": "light",
  "count": 2
}

encoding=”utf-8″ を省略するとどうなるか

Windows の Python 3.12 では、encoding を省略すると、日本語版 Windows の標準の文字コード(cp932、Shift_JIS を Microsoft が拡張したもの)でファイルを開きます。この PC で locale.getpreferredencoding(False) を確かめると cp932 でした。JSON ファイルは UTF-8 で書かれていることがほとんどなので、ずれが起きます。

UTF-8 で保存した JSON を、encoding なしの open() で読み込んだ結果です。中身の文字によって、文字化けするものとエラーになるものがありました。

ファイルの中身(UTF-8)encoding なしで json.load した結果
{"city": "東京都"}{'city': '譚ア莠ャ驛ス'}(文字化け)
{"msg": "こんにちは"}{'msg': '縺薙s縺ォ縺。縺ッ'}(文字化け)
{"name": "田中太郎"}UnicodeDecodeError: ‘cp932’ codec can’t decode byte 0x8e in position 21: illegal multibyte sequence

文字化けしたほうはエラーにならずに読めてしまうので、気づかずに処理を進めてしまう危険があります。書き込むときも、encoding なしで ensure_ascii=False を付けると cp932 で保存されてしまいます。読むときも書くときも encoding="utf-8" を付けましょう。

BOM 付きの JSON ファイルは utf-8-sig で開く

メモ帳などで「UTF-8(BOM 付き)」として保存したファイルは、先頭に BOM という目印の 3 バイトが付いています。これを encoding="utf-8" で開いて json.load すると、次のエラーになります。

json.decoder.JSONDecodeError: Unexpected UTF-8 BOM (decode using utf-8-sig): line 1 column 1 (char 0)

メッセージのとおり、open("data.json", encoding="utf-8-sig") で開けば読み込めました。utf-8-sig は BOM があれば取り除き、なければ普通の UTF-8 として読むので、BOM の有無が分からないファイルにも使えます。BOM については「UTF-8とは?」で詳しく解説しています。

datetime などを変換できない:TypeError と default 引数

日時(datetime)を含む dict を json.dumps すると、次のエラーになります。

import json
from datetime import datetime

d = {"created": datetime(2026, 10, 18, 9, 30)}
print(json.dumps(d))
TypeError: Object of type datetime is not JSON serializable

「datetime 型のオブジェクトは JSON にできない」という意味です。JSON には日時の型がないため、文字列などに変えてから渡す必要があります。set、Decimal、自分で作ったクラスでも同じエラーになります(dataclass で作ったクラスは、dataclasses.asdict() で dict に変えてから渡します)。

このときは default 引数に関数を指定します。JSON にできない値があるたびにその関数が呼ばれ、戻り値が代わりに使われます。

import json
from datetime import date, datetime
from decimal import Decimal

def to_json(obj):
    if isinstance(obj, (date, datetime)):
        return obj.isoformat()
    if isinstance(obj, Decimal):
        return str(obj)
    if isinstance(obj, set):
        return sorted(obj)
    raise TypeError(f"{type(obj).__name__} は JSON に変換できません")

print(json.dumps({"created": datetime(2026, 10, 18, 9, 30)}, default=to_json))
print(json.dumps({"price": Decimal("1.10"), "tags": {"b", "a"}}, default=to_json))
{"created": "2026-10-18T09:30:00"}
{"price": "1.10", "tags": ["a", "b"]}

日時は isoformat() で 2026-10-18T09:30:00 という ISO 8601 形式の文字列にしています。読み込むときは文字列のまま戻ってくるので、datetime.fromisoformat("2026-10-18T09:30:00") で datetime に戻します。関数の最後で TypeError を出しているのは、想定していない型が来たときに黙って変な値にしないためです(公式ドキュメントでも、変換できないときは TypeError を出すように書かれています)。

手軽に済ませたいときは default=str と書く方法もあります。この場合、datetime は "2026-10-18 09:30:00"(T ではなく空白区切り)になり、どんな値も文字列にしてしまうので、意図しない値が紛れ込んでも気づけません。用途に合わせて選びましょう。Unix 時間(1970 年からの秒数)で日時をやり取りする場合は、Unix時間変換ツールで値を確かめられます。

JSONDecodeError の読み方(行・列)

JSON の書き方に誤りがあると、json.loads・json.load は JSONDecodeError を出します。最後の行は、次の 3 つの部分に分けて読みます。

json.decoder.JSONDecodeError: Expecting property name enclosed in double quotes: line 4 column 1 (char 31)
  • Expecting property name enclosed in double quotes:エラーの内容(「ダブルクォートで囲んだキーが来るはずだった」)
  • line 4 column 1:4 行目の 1 文字目で読めなくなった(行も列も 1 から数える)
  • char 31:先頭から数えて何文字目か(0 から数える。バイト数ではなく文字数)

注意したいのは、示される場所は「読めなくなった場所」で、間違いのある場所とは限らないことです。このエラーは、次の JSON を読み込んだときのものです。

{
  "name": "田中",
  "age": 25,
}

本当の原因は 3 行目の最後の「,」(JSON では最後の要素の後ろに , を書けない)ですが、Python は「, の次にキーが来るはず」と読み進めて、4 行目の } でエラーにしています。示された場所で原因が見つからないときは、その直前を確認しましょう。

よく出るメッセージと原因

Python 3.12 で実際に出たメッセージです。Web API の応答で「Expecting value: line 1 column 1 (char 0)」が出たときは、受け取った文字列を print して、空やエラーページでないか確かめましょう。

メッセージ読み込んだものよくある原因
Expecting value: line 1 column 1 (char 0)空の文字列、<!DOCTYPE html>中身が空、または JSON ではなく HTML(エラーページなど)を受け取っている
Expecting property name enclosed in double quotes{'name': 'Tanaka'}、最後に , がある JSONシングルクォートを使っている、最後の要素の後ろに , がある
Expecting ‘,’ delimiter"a": 1 の次の行に "b": 2要素と要素の間の , が抜けている
Expecting value: line 1 column 7{"a": True}Python の書き方(True・None)になっている。JSON では true・null
Extra data{"a": 1}{"b": 2}、{"a": 1} // memoJSON が 2 つ以上つながっている、後ろにコメントなど余計なものがある
Invalid \escape{"path": "C:\Users\tanaka"}Windows のパスの \ をそのまま書いている。JSON では \\ と書く

エラーの行を表示するプログラム

JSONDecodeError には、エラーの内容(msg)、行(lineno)、列(colno)、位置(pos)が入っています。これを使うと、エラーの行をそのまま表示できます。次を check.py として保存します。

import json
import sys

path = sys.argv[1]
with open(path, encoding="utf-8") as f:
    text = f.read()

try:
    data = json.loads(text)
except json.JSONDecodeError as e:
    print(f"{path} の {e.lineno} 行目 {e.colno} 文字目: {e.msg}")
    line = text.splitlines()[e.lineno - 1]
    print(line)
    print(" " * (e.colno - 1) + "^")
    sys.exit(1)

print("OK")

最後の要素の後ろに , がある broken.json を指定して実行します。

py check.py broken.json
broken.json の 5 行目 1 文字目: Expecting property name enclosed in double quotes
}
^

JSONDecodeError は ValueError の仲間(サブクラス)なので、except ValueError でも受け取れます。どの行が悪いのかを画面で確かめたいときは、JSON 整形ツールに貼ると、エラーの場所と直し方を日本語で表示します。

よくある間違い

load と loads を取り違える

s の有無を間違えると、次のようなエラーになります。

間違った書き方エラー
json.loads("settings.json")JSONDecodeError: Expecting value: line 1 column 1 (char 0)(ファイル名の文字列を JSON として読もうとしている)
json.load("settings.json")AttributeError: ‘str’ object has no attribute ‘read’(ファイル名ではなく、open() したファイルを渡す)
json.loads(f)(f は open() したファイル)TypeError: the JSON object must be str, bytes or bytearray, not TextIOWrapper

str(dict) で JSON を作ろうとする

print(data) や str(data) で出てくる文字列は、Python の書き方であって JSON ではありません。

str(data)        → {'active': True, 'manager': None}
json.dumps(data) → {"active": true, "manager": null}

シングルクォート、True、None は JSON では使えないので、ほかのプログラムに渡すと読み込めません。JSON が必要なときは必ず json.dumps を使います。

1 つのファイルに json.dump を何度も書く

同じファイルに json.dump を 2 回続けると、中身は {"id": 1}{"id": 2} になり、読み込むと「Extra data: line 1 column 10 (char 9)」になります。JSON ファイル 1 つには、値を 1 つだけ入れるのが決まりです。複数のデータは、全体を list にまとめてから 1 回で json.dump します。

ログのように 1 件ずつ追記したい場合は、1 行に 1 つの JSON を書く「JSON Lines」という形式がよく使われます。

import json

rows = [{"id": 1, "name": "田中"}, {"id": 2, "name": "佐藤"}]
with open("log.jsonl", "w", encoding="utf-8") as f:
    for r in rows:
        f.write(json.dumps(r, ensure_ascii=False) + "\n")

with open("log.jsonl", encoding="utf-8") as f:
    for line in f:
        print(json.loads(line)["name"])

log.jsonl の中身は {"id": 1, "name": "田中"} と {"id": 2, "name": "佐藤"} の 2 行になり、1 行ずつ json.loads すると「田中」「佐藤」と表示されました。この場合は indent を付けないこと(1 件が複数行になってしまうため)に注意します。

よくある質問

大きな整数や、金額のような小数は正確に読めますか?

整数は正確に読めます。Python の int には桁数の上限がないため、12345678901234567890 もそのまま int になりました(JavaScript ではこの値の下の桁が変わります)。小数は float になるので、0.1 のような値はわずかな誤差を含みます。金額など誤差を避けたいときは、json.loads(text, parse_float=Decimal) とすると、1.10 が Decimal('1.10') として読み込まれます。

まとめ

  • 文字列は json.loads・json.dumps、ファイルは json.load・json.dump
  • 日本語をそのまま出すなら ensure_ascii=False、見やすくするなら indent=2
  • ファイルを開くときは encoding="utf-8"(BOM 付きなら utf-8-sig)を必ず付ける
  • datetime などの TypeError は default 引数で文字列に変える
  • JSONDecodeError は「line ◯ column ◯」の場所と、その直前を確認する

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました