La respuesta corta
- JSON Lines es un formato de texto que almacena datos estructurados con un valor JSON por línea y exige UTF-8 sin BOM y ninguna línea vacía.
- En Windows o macOS, abre el archivo con un editor de texto compatible con UTF-8. En el móvil, utiliza un editor que pueda acceder al archivo y leer UTF-8; sus límites de tamaño dependen de la aplicación. Para procesarlo, analiza cada línea por separado con un analizador JSON. Su estructura permite usar herramientas de texto Unix y tuberías de shell. Admite LF y CRLF. JSON Lines recomienda el salto de línea final; NDJSON lo exige después de cada texto JSON.
- El riesgo inherente del formato es bajo: la sintaxis JSON válida excluye asignaciones y llamadas a funciones. Usa un analizador JSON para texto no confiable; eval y funciones similares pueden introducir ejecución de código. Poder analizar el archivo no demuestra que sus datos sean fiables ni que una conversión haya conservado todos los valores.
JSON Lines (.jsonl, .ndjson): abrir y convertir archivos
JSON Lines, también llamado JSON delimitado por saltos de línea, sirve para procesar registros, logs y mensajes de forma individual. Cada línea puede contener un objeto, un arreglo o un valor escalar; null es válido. JSON Lines usa .jsonl y la especificación NDJSON recomienda .ndjson. La documentación de JSON Lines propone application/jsonl, pero indica que no está estandarizado; NDJSON recomienda application/x-ndjson.
Para convertir JSONL en un documento JSON convencional, reúne los valores de las líneas, en su orden original, dentro de un arreglo. Esta conclusión se deriva de la estructura de ambos formatos; cambiar la extensión no realiza la conversión. Revisa las claves duplicadas y la precisión numérica antes de analizar y exportar. Para CSV también debes definir cómo representar arreglos, valores anidados y registros con campos distintos.
Cómo abrirlo
En Windows o macOS, abre el archivo con un editor de texto compatible con UTF-8. En el móvil, utiliza un editor que pueda acceder al archivo y leer UTF-8; sus límites de tamaño dependen de la aplicación. Para procesarlo, analiza cada línea por separado con un analizador JSON. Su estructura permite usar herramientas de texto Unix y tuberías de shell. Admite LF y CRLF. JSON Lines recomienda el salto de línea final; NDJSON lo exige después de cada texto JSON.
En Windows o macOS, abre el archivo con un editor de texto compatible con UTF-8. En el móvil, utiliza un editor que pueda acceder al archivo y leer UTF-8; sus límites de tamaño dependen de la aplicación. Para procesarlo, analiza cada línea por separado con un analizador JSON. Su estructura permite usar herramientas de texto Unix y tuberías de shell. Admite LF y CRLF. JSON Lines recomienda el salto de línea final; NDJSON lo exige después de cada texto JSON.
Para convertir JSONL en un documento JSON convencional, reúne los valores de las líneas, en su orden original, dentro de un arreglo. Esta conclusión se deriva de la estructura de ambos formatos; cambiar la extensión no realiza la conversión. Revisa las claves duplicadas y la precisión numérica antes de analizar y exportar. Para CSV también debes definir cómo representar arreglos, valores anidados y registros con campos distintos.
Seguridad
El riesgo inherente del formato es bajo: la sintaxis JSON válida excluye asignaciones y llamadas a funciones. Usa un analizador JSON para texto no confiable; eval y funciones similares pueden introducir ejecución de código. Poder analizar el archivo no demuestra que sus datos sean fiables ni que una conversión haya conservado todos los valores.
Un remitente desconocido, un nombre que acaba en dos extensiones o un contenido que no cuadra con la extensión: compruébalo antes de abrirlo.
Cómo convertirlo
Para convertir JSONL en un documento JSON convencional, reúne los valores de las líneas, en su orden original, dentro de un arreglo. Esta conclusión se deriva de la estructura de ambos formatos; cambiar la extensión no realiza la conversión. Revisa las claves duplicadas y la precisión numérica antes de analizar y exportar. Para CSV también debes definir cómo representar arreglos, valores anidados y registros con campos distintos.
Convierte una copia, nunca el original, y después compara calidad, metadatos y maquetación con el archivo de partida.
Preguntas frecuentes
¿Qué es un archivo JSON Lines y para qué sirve?
Es un archivo de texto con un valor JSON por línea, útil para procesar registros, logs y mensajes individualmente. Cada línea puede contener un objeto, un arreglo o un escalar, incluido null. Las líneas vacías no son registros válidos de JSON Lines.
¿Cómo abrir archivos JSONL en Windows?
Abre el archivo .jsonl desde un editor de texto compatible con UTF-8. Cada línea representa un valor JSON independiente. Para procesar los registros, utiliza un analizador que lea JSON línea por línea; uno que espere un solo documento puede rechazar el archivo.
¿Cómo abrir archivos JSONL en Mac?
Usa un editor en modo de texto plano con codificación UTF-8. Cada registro debe ocupar una línea. Para trabajar desde la terminal, puedes aprovechar herramientas de texto Unix y tuberías de shell, analizando después cada línea como JSON.
¿Cómo abrir archivos NDJSON en el móvil?
Elige un editor de texto que pueda acceder al archivo en el móvil y leer UTF-8, y abre allí el .ndjson. El tamaño admitido y el acceso a archivos dependen de la aplicación; la extensión no garantiza compatibilidad con cualquier editor móvil.
¿Por qué aparecen errores de NDJSON por líneas vacías?
JSON Lines no permite líneas vacías. Los analizadores NDJSON pueden ignorarlas si documentan ese comportamiento y deberían permitir configurarlo, por lo que las herramientas pueden diferir. Revisa también si hay JSON incompleto o un registro dividido entre varias líneas.
¿Conviene usar JSON Lines o JSON convencional para varios registros?
Usa JSON Lines si necesitas leer o procesar registros individualmente por línea. Elige un arreglo JSON convencional si el destinatario espera un único documento JSON. Varios valores separados por saltos de línea no constituyen un solo documento JSON válido.
¿Cómo convertir JSONL en un arreglo JSON?
Analiza cada línea como un valor JSON, conserva el orden y escribe todos los valores dentro de un arreglo, separados por comas. Esta conversión se deduce de la estructura de los formatos. Cambiar .jsonl por .json no transforma los registros.
¿Qué pérdida de datos debo comprobar al convertir JSONL a CSV?
Define cómo asignar objetos anidados, arreglos y registros con campos distintos a columnas CSV. Revisa también claves duplicadas y números grandes o de alta precisión: el analizador puede conservar solo el último valor duplicado o alterar números que excedan su precisión.
¿Qué riesgos hay al analizar archivos JSONL de origen desconocido?
La sintaxis JSON válida excluye asignaciones y llamadas a funciones, pero eval y funciones similares pueden introducir ejecución de código al procesar texto no confiable. Usa un analizador JSON. Que el archivo se pueda analizar no demuestra que sus datos sean fiables.
¿Cómo corregir errores de codificación UTF-8 en JSON Lines?
Comprueba la codificación original y guarda una copia correctamente decodificada como UTF-8 sin BOM. Es un requisito de JSON Lines. Si una lectura anterior ya sustituyó caracteres, cambiar la etiqueta de codificación no recuperará el texto original.
¿Qué límites de tamaño y anidamiento tienen los archivos JSONL?
Las especificaciones citadas no fijan un límite universal para abrirlos. Cada analizador puede limitar el tamaño del texto, la profundidad y la longitud de las cadenas. Los sustitutos Unicode no emparejados también pueden provocar comportamientos impredecibles o errores de ejecución.
Formatos relacionados
Fuentes
JSON Lines — 官方格式文档 · JSON Lines 格式项目，维护者 Ian Ward
NDJSON — Newline delimited JSON Specification · NDJSON 官方规范仓库
RFC 8259 — The JavaScript Object Notation (JSON) Data Interchange Format · IETF Standards Track / RFC Editor