json_repair

修復來自LLM、API、日誌和使用者輸入的格式錯誤JSON(Python)

json_repair 是什麼?

修復來自LLM、API、日誌和使用者輸入的格式錯誤JSON(Python)

json_repair 概覽

這是什麼

json_repair 是一個 Python 函式庫,用於修復來自大型語言模型、API、日誌和使用者輸入的格式錯誤 JSON 字串。它能修復缺少的引號、逗號、括號、註解、多餘文字以及被截斷的值。可作為 json.loads() 的備用方案,或作為基於結構的修復步驟。

主要功能

  • 修復缺少的引號、錯置的逗號、未跳脫字元以及不完整的鍵值對。
  • 修復不完整的陣列和物件,加入必要元素(如逗號、括號)或預設值(null、空字串)。
  • 自動以合理的預設值(如空字串或 null)補齊 JSON 中遺漏的值。
  • 辨識 Python 風格的元組:以逗號分隔的括號序列會轉為 JSON 陣列,單一括號值則維持為純量。
  • 在陣列、物件和元組中,不區分大小寫地將 true/false/null 和 None 辨識為 JSON 布林值或 null。
  • 提供 loads() 和 load() 作為 json.loads() 和 json.load() 的直接替代,並有 from_file() 方法從檔案讀取。
  • 支援 skip_json_loads=True 以跳過初始的嚴格 JSON 驗證,直接進入修復解析器。

使用情境

  • 修復大型語言模型輸出中格式錯誤的 JSON,這些模型可能遺漏括號或加入多餘文字。
  • 修復來自 API、日誌或使用者輸入、包含語法錯誤(如缺少引號、錯置逗號或未跳脫字元)的 JSON。
  • 在不完整的資料結構中自動補齊遺漏的 JSON 值。
  • 清理包含額外非 JSON 字元(如註解或錯置字元)的 JSON。

快速開始

pip install json-repair然後在程式碼中使用:pythonfrom json_repair import repair_jsongood_json_string = repair_json(bad_json_string)或作為 json.loads() 的直接替代:pythonimport json_repairdecoded_object = json_repair.loads(json_string)

授權與價格

此函式庫採用 MIT 授權條款,為開放原始碼。對所有人免費。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/mangiucugnajson-repair.svg)](https://yunodb.com/tools/mangiucugnajson-repair?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/mangiucugnajson-repair?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/mangiucugnajson-repair.svg" alt="Featured on YunoDB" height="20"></a>