Cómo abrir un archivo JSON

La respuesta corta

Los archivos JSON (JavaScript Object Notation) guardan datos como texto: claves y valores entre llaves, listas entre corchetes. No tienen nada binario ni propietario, así que nunca necesitas un programa especial solo para ver lo que contienen. Haz clic derecho en el archivo, elige Abrir con y selecciona un editor de texto o un navegador.

El problema es la legibilidad. Los archivos que exportan las apps y las API suelen estar en una sola línea larguísima, perfecta para los programas e ilegible para las personas. Suelta el archivo en el visor de abajo (o pulsa Abrir archivo) y lo verás como un árbol que se abre y se cierra, con el número de elementos en cada lista y objeto. Cambia Herramienta a Formateador si prefieres texto con sangría.

De dónde salen los archivos JSON

Normalmente te encuentras un .json en alguna de estas situaciones: una exportación de datos de una web o app (Google Takeout, la descarga de datos de Instagram o Facebook, apps de banco o de deporte), una respuesta guardada de una API, el archivo de configuración de un programa o un juego, el catálogo de productos de una tienda online o la copia de seguridad de una extensión del navegador.

Esto importa porque el objetivo cambia. En un archivo de configuración quieres cambiar un valor y guardarlo sin romper la sintaxis. En una exportación quieres encontrar un campo entre miles de líneas o pasar los datos a una hoja de cálculo. Los métodos de abajo cubren las tres cosas: leer, editar y convertir.

Formas de abrir un JSON, comparadas

Paso a paso en cada dispositivo

• Windows: clic derecho en el archivo, Abrir con y luego Bloc de notas. Para dejarlo como predeterminado, entra en Elegir otra aplicación y marca la casilla para usar siempre esa app con los archivos .json. Para una vista ordenada, arrastra el archivo a una ventana de Firefox o al visor de esta página.
• Mac: clic derecho (o Control y clic) en el archivo, Abrir con y luego TextEdit. Si seleccionas el archivo en Finder y pulsas la barra espaciadora, ves una vista rápida del texto sin abrir ninguna app.
• iPhone y iPad: en la app Archivos, toca el archivo para previsualizarlo como texto. Para recorrerlo como árbol, abre esta página en Safari, toca Abrir archivo y elígelo desde Archivos.
• Android: la mayoría de los gestores de archivos ofrecen abrir el .json con un visor de texto o el navegador. Para la vista ordenada y desplegable, abre esta página en Chrome y usa Abrir archivo.
• Línea de comandos: python -m json.tool archivo.json imprime una copia formateada, y jq . archivo.json hace lo mismo con colores si tienes jq instalado.

Leer un JSON grande con comodidad

Las exportaciones grandes pueden tener decenas de miles de líneas. En el visor, todo lo que está por debajo de los dos primeros niveles empieza cerrado, así que primero ves la estructura general: un objeto con cinco claves, un array con 2481 elementos. Abres solo la rama que te interesa. Expandir todo y Contraer todo, encima de la entrada, abren o cierran el documento entero; los documentos muy grandes se expanden hasta un límite seguro para que la página siga fluida.

Al pasar el cursor por un nodo ves su ruta, por ejemplo $.orders[3].customer.name. Es justo lo que necesitas al escribir código o una fórmula que lea ese mismo campo, y te ahorra contar corchetes a mano.

Los archivos de varios megabytes se abren sin problema. Más allá de eso, el límite lo pone la memoria de tu dispositivo y no la herramienta, y el coloreado se desactiva en resultados muy grandes para que el desplazamiento siga siendo fluido.

Editar un JSON sin romperlo

JSON es estricto: un solo carácter fuera de lugar hace que el programa que lo usa no pueda leer el archivo entero. Si vas a editar un archivo de configuración, guarda antes una copia y revisa el resultado antes de guardar.

• Las claves y los valores de texto van entre comillas dobles. Las comillas simples no valen.
• No pongas coma después del último elemento de un objeto o un array.
• Nada de comentarios. Las líneas que empiezan con // o los bloques entre /* y */ no son válidos en JSON estándar.
• true, false y null se escriben en minúsculas y sin comillas.
• Guarda el archivo como texto plano UTF-8. Los procesadores de texto como Word añaden formato y no sirven para esto.

Si el archivo no abre o se ve raro

Si el visor dice Esto no es un JSON válido, el cuadro de error muestra la línea y la columna donde empieza el problema junto con las líneas de alrededor. Las causas habituales son las de la lista anterior: una coma que falta o sobra, comillas simples o un comentario. Cuando lo corrijas, cambia Herramienta a Validador para comprobarlo; un archivo válido recibe un resumen como 120 claves, 15 objetos, 3 arrays, 4 niveles de profundidad.

Algunos archivos con extensión .json son en realidad JSON Lines (un objeto JSON completo por línea, normalmente .jsonl o .ndjson). No forman un documento válido único; ábrelos línea por línea o envuelve las líneas entre corchetes separándolas con comas.

Si ves letras extrañas como é en lugar de é o ñ en lugar de ñ, el archivo se abrió con una codificación equivocada. JSON debe estar en UTF-8; ábrelo con un editor que te deje elegir UTF-8 o usa el visor, que lee el archivo como UTF-8.

Pasar un JSON a una hoja de cálculo

Cuando el archivo es una lista de registros (pedidos, contactos, productos), una tabla es más cómoda que un árbol. Cambia Herramienta a JSON a CSV: cada elemento se convierte en una fila, cada clave en una columna, y los objetos anidados como una dirección se aplanan en columnas como address.city. La vista previa muestra las primeras 100 filas y el CSV descargado se abre en Excel con las tildes y la ñ intactas.

Excel también puede importar JSON directamente con Datos, Obtener datos, Desde un archivo, Desde JSON, que abre el editor de Power Query. Es potente, pero expandir los registros anidados lleva varios clics y está disponible sobre todo en las versiones para Windows.