Reparació JSON

Relacionats

Què és la reparació JSON (JSON Repair)?

Casos d'ús

• Neteja de sortida d'IA/LLM: converteix amb un sol clic JSON amb embolcall Markdown, text explicatiu i comes finals retornat per ChatGPT/Claude a JSON estàndard
• Depuració i resolució de problemes d'API: quan les respostes d'API es trunquen per problemes de passarel·la o xarxa, completa ràpidament claudàtors i cadenes per localitzar l'estructura de dades original
• Literals d'objecte JavaScript copiats de la consola: correcció integral de cometes simples, comes finals i claus sense cometes
• Neteja de fitxers de configuració: elimina comentaris de JSON5/JSONC per obtenir JSON estàndard, llest per a connexió unificada a serveis posteriors
• Reparació de dades de registre i porta-retalls: estandarditza ràpidament fragments JSON que contenen comentaris, espais en blanc especials o truncament
• Preprocessament de migració de dades i scripts: afegeix un pas de reparació al pipeline de migració de dades per evitar que uns quants JSON invàlids bloquegin tot el lot ETL

Com usar-ho

1. Enganxa el contingut JSON amb errors, embolicat en Markdown o truncat a la caixa d'entrada esquerra, o fes clic a 'Mostra' per carregar un JSON danyat típic, o puja un fitxer .json/.txt
2. L'eina detecta i repara automàticament els problemes de sintaxi comuns; l'àrea de sortida dreta mostra el JSON estàndard formatat i el recompte de cada tipus de problema reparat
3. Si encara queden missatges d'error vermells, pots editar manualment l'entrada i tornar a activar la reparació (Mac: ⌘+Shift+R, Windows: Ctrl+Shift+R)
4. Després de confirmar que l'estructura és correcta, fes clic a 'Copiar' per posar el resultat reparat al porta-retalls, o fes clic a 'Descarregar' per desar com a repaired.json per continuar amb formatat, validació, etc.

Característiques

• Cobreix 7 tipus d'errors de sintaxi comuns: comes finals, cometes simples, claus sense cometes, cadenes no tancades, comentaris, claudàtors mancants, embolcalls de blocs de codi Markdown
• Neteja de sortida d'IA optimitzada: elimina automàticament embolcalls ```json i text explicatiu fora dels blocs de codi, reconeix la sortida típica de ChatGPT, Claude, Gemini i altres LLM
• Compatible amb JSON5/JSONC: analitza sintaxi estesa incloent comentaris, cometes laxes i espais en blanc especials (com caràcters Unicode invisibles)
• Compleció intel·ligent de JSON truncat: gestiona respostes d'API truncades i claudàtors de tancament mancants completant automàticament claudàtors i cometes que falten
• Visualització de problemes de reparació: compta i mostra automàticament quantes vegades s'ha reparat cada tipus de problema, facilitant l'auditoria i la revisió manual
• Processament local per a la privadesa: l'anàlisi, reparació i formatat es fan al navegador, el contingut d'entrada no s'envia a cap servidor
• Transició perfecta al formatat: el JSON estàndard reparat pot entrar directament al formatat JSON, validació Schema i generació de codi amb un sol clic
• Càrrega de fitxers i mostres: admet la càrrega de fitxers .json/.txt o fer clic per carregar una mostra per verificar ràpidament l'efecte de la reparació

Exemples de codi

// npm install jsonrepair
import { jsonrepair } from 'jsonrepair';

const broken = `{
  name: 'Alice',
  age: 30,
  tags: ['dev', 'writer',], // trailing comma + comment
}`;

try {
  const fixed = jsonrepair(broken);
  const obj = JSON.parse(fixed);
  console.log(obj);
  // => { name: 'Alice', age: 30, tags: ['dev', 'writer'] }
} catch (err) {
  console.error('Still unrepairable:', err.message);
}

# pip install jsonrepair
from jsonrepair import jsonrepair
import json

broken = '''{
  name: "Alice",
  age: 30,
  tags: ["dev", "writer",], // trailing comma + comment
}'''

fixed = jsonrepair(broken)
obj = json.loads(fixed)
print(obj)
# => {'name': 'Alice', 'age': 30, 'tags': ['dev', 'writer']}

# Elimina comes finals d'objectes/arrays (opció d'emergència; NO gestiona comentaris / cometes simples)
# Per a escenaris complexos, utilitza una biblioteca dedicada com jsonrepair
sed -E 's/,([ \t]*[}\]])/\1/g' broken.json > clean.json

# Valida la sortida reparada
jq . clean.json >/dev/null && echo 'JSON is valid'

Preguntes freqients

Solució de problemes

Glossari

JSON

JavaScript Object Notation, un format lleuger d'intercanvi de dades basat en parells clau-valor, definit a RFC 8259. Estàndard de facto per a API REST, fitxers de configuració i registres.

RFC 8259

L'especificació oficial de JSON publicada per IETF, que defineix la sintaxi estricta del JSON vàlid — totes les claus han d'estar entre cometes dobles, només un conjunt limitat de caràcters en cadenes necessita escapament, no es permeten comentaris ni comes finals.

JSON.parse

L'analitzador JSON estricte integrat a JavaScript i als navegadors moderns, seguint RFC 8259. Llança SyntaxError directament davant qualsevol error de sintaxi i no pot realitzar reparació tolerant.

JSON5

Sintaxi estesa per a JSON (no estàndard), que permet claus sense cometes, cadenes amb cometes simples, comentaris (// i /* */), comes finals, nombres hexadecimals, etc. Més fàcil d'escriure per a humans però incompatible amb JSON.parse.

JSONC

JSON with Comments, nom genèric utilitzat per editors com VS Code per a fitxers de configuració JSON amb comentaris (com tsconfig.json). En realitat, un àlies comú de JSON5.

Trailing Comma / Coma final

Una coma extra després de l'últim element d'un objecte o array. Permès en JavaScript però prohibit per l'estàndard JSON — l'error de sintaxi més comú de la sortida de LLM i còpies de console.log().

Bloc de codi Markdown

Un fragment de codi embolicat en tres accents greus (```). Els LLM sovint emboliquen automàticament la sortida JSON en ```json ... ```; enganxar-ho directament a JSON.parse() fallarà.

Tolerant Parser / Analitzador tolerant

Un analitzador capaç d'intentar recuperar-se i continuar l'anàlisi en trobar errors de sintaxi. El motor central d'una eina de reparació JSON, diferent del JSON.parse estricte.

SyntaxError

L'excepció d'error de sintaxi llançada per JavaScript. Qualsevol analitzador JSON estricte llança això en rebre entrada que no compleix RFC 8259.

Canonical JSON / JSON canònic

JSON regenerat mitjançant parse + stringify, amb ordre de claus estable, sense espais en blanc sobrants i 100% compatible amb analitzadors estàndard. El format de sortida final d'una eina de reparació JSON.

Tipus d'errors comuns de reparació JSON amb exemples

Reparació JSON vs Formatat JSON vs Validació JSON Schema

Authoritative References

• IETFEspecificació oficial JSON (RFC 8259)
• MDNJSON.parse - Documentació web MDN
• JSON5JSON5 - Especificació de sintaxi estesa no oficial
• GitHubjsonrepair (josdejong) - Implementació de referència per a navegador i Node