Python `json.loads` 的 `strict=True / False` 快速指南 \n vs \\n ; \t vs \\t 那一個是合法json?

by 儲蓄保險王 · 2026-07-05

$Python `json.loads` 的 `strict=True / False` 快速指南 n vs \n ; t vs \t 那一個是合法json? - 儲蓄保險王$

`json.loads()` / `json.load()` 有個 `strict` 參數，**預設 `True`**。它只管一件事：

**字串值裡能不能出現「未跳脫的控制字元」**——也就是「換行字元本身、tab 字元本身」

（按 Enter／Tab 直接打進去的那個字元），而不是 `\n`、`\t` 這種跳脫寫法。

json.loads(s, *, strict=True)   # 預設

json.loads(s, *, strict=True)   # 預設

Python `json.loads` 的 `strict=True / False` 快速指南 n vs \n ; t vs \t 那一個是合法json? - 儲蓄保險王

一個例子看懂

import json

# 字串值裡有「換行字元本身」（按 Enter 打進去的，不是 \n 跳脫寫法）→ 不合法 JSON
bad = '{"description": "line1\nline2"}'

json.loads(bad)                 # ❌ JSONDecodeError: Invalid control character...
json.loads(bad, strict=False)   # ✅ {'description': 'line1\nline2'}

import json

# 字串值裡有「換行字元本身」（按 Enter 打進去的，不是 \n 跳脫寫法）→ 不合法 JSON
bad = '{"description": "line1\nline2"}'

json.loads(bad)                 # ❌ JSONDecodeError: Invalid control character...
json.loads(bad, strict=False)   # ✅ {'description': 'line1\nline2'}

正確做法是把換行「跳脫」成 \n（兩個字元 \ + n），這樣連 strict=True 都沒問題：

good = '{"description": "line1\\nline2"}'   # 合法 JSON

json.loads(good)                # ✅ 不必 strict=False

good = '{"description": "line1\\nline2"}'   # 合法 JSON

json.loads(good)                # ✅ 不必 strict=False

good 與 bad 解析出來的結果完全一樣，差別只在「來源文字合不合法」。 strict=False 本質就是「寬容地把 bad 當 good 來讀」。

什麼是「控制字元」？

ASCII 0x00–0x1F 的不可見字元，常見：

JSON 標準要求它們必須跳脫；直接塞真字元進字串值就是不合法。

三個關鍵觀念

strict 只管控制字元——它不會修復其他錯誤（少括號、多逗號、key 沒引號、Extra data…）。那些在 True / False 下都一樣失敗。
和 encoding 無關——encoding 是「bytes → 文字」的解碼（失敗是 UnicodeDecodeError）；strict 是「文字 → JSON」的解析（失敗是 JSONDecodeError）。兩個不同階段。
救回來的字元還在——strict=False 只是允許解析，不會刪字元。真的換行會變成字串裡的一個 \n 字元；不想要得自己 .replace()。

建議用法

try:
    data = json.loads(text)                 # 先嚴格：乾淨檔正常過
except json.JSONDecodeError:
    data = json.loads(text, strict=False)   # 失敗才寬鬆：救含控制字元的髒檔
    print("⚠️ loaded with strict=False")     # 留個痕跡，知道這檔不乾淨

try:
    data = json.loads(text)                 # 先嚴格：乾淨檔正常過
except json.JSONDecodeError:
    data = json.loads(text, strict=False)   # 失敗才寬鬆：救含控制字元的髒檔
    print("⚠️ loaded with strict=False")     # 留個痕跡，知道這檔不乾淨