Elige según la estructura
JSON representa explícitamente arreglos, objetos, cadenas, números, valores booleanos y null. Resulta natural para intercambiar datos anidados de API y configuraciones que leerá un programa. CSV es una tabla: cada registro contiene campos en un orden de columnas compartido. Es cómodo para filas sencillas y para importar en hojas de cálculo, pero una celda no indica por sí misma si 0012 es identificador, número o texto. YAML suele utilizarse en configuraciones editadas por personas gracias a sus mapas, secuencias e indentación legible; sus reglas de análisis también exigen cuidado. JSON Lines guarda un valor JSON completo por línea, lo que facilita añadir o procesar registros por separado. Prioriza la estructura exigida por el software receptor, no la extensión más conocida.
Un ejemplo en cuatro representaciones
Considera el arreglo JSON [{"id":1,"city":"Paris"},{"id":2,"city":"Lima"}]. Una exportación CSV sencilla contiene la cabecera id,city y después las filas 1,Paris y 2,Lima. YAML puede mostrar una secuencia de dos mapas, cada uno con id y city. En JSON Lines la primera línea es {"id":1,"city":"Paris"} y la segunda {"id":2,"city":"Lima"}; no existe un arreglo externo. Los conversores enlazados permiten inspeccionar estas variantes. Observa qué ocurre si city contiene una coma, comillas o un salto de línea: CSV necesita comillas y escapes según el dialecto del lector. El ejemplo breve oculta esa complejidad; antes de exportar miles de filas, ensaya valores reales.
- JSON: arreglo de objetos tipados
- CSV: cabecera y filas planas · YAML: mapas indentados
- JSON Lines: un objeto JSON por línea
Decide qué hacer con tipos y datos anidados
Un objeto JSON puede contener otro objeto o un arreglo. Una fila CSV plana no expresa esa estructura sin una convención, como columnas separadas, JSON serializado dentro de una celda o varias tablas. Toda conversión debe escoger una política; revisa la salida antes de asumir que no se perdió información. Los números y booleanos pueden convertirse en texto de celda en CSV, y al importarlos quizá debas asignarles tipos explícitos. El cero inicial de un identificador de cuenta importa aunque una hoja de cálculo quiera tratarlo como número. YAML admite datos estructurados, pero conviene revisar escalares sin comillas e indentación con el analizador de destino. JSON Lines mantiene los tipos JSON en cada registro; cada línea física debe ser un valor JSON válido.
Prueba ida y vuelta con registros representativos
Antes de convertir un archivo entero, prepara una muestra con una fila normal, un campo vacío, comillas, coma, un carácter no ASCII y un valor anidado si existe en tus datos. Conviértela y vuelve al formato inicial cuando haya herramienta inversa. Compara estructura y tipos, no solo el texto visible. Revisa nombres de columnas, número de registros, orden y diferencia entre null y cadena vacía. En JSON Lines comprueba que los registros estén separados por saltos de línea y que un objeto formateado en varias líneas no se haya interpretado como varios registros. El conversor JSON a CSV integrado empieza con dos entradas sencillas; modifica una y examina la tabla de salida. Los demás enlaces permiten ensayar YAML y archivos delimitados por líneas.
Adapta la importación al destino
Para una hoja de cálculo con registros planos y uniformes, CSV suele ser práctico; documenta delimitador, codificación y tipos de columna esperados. Si los valores vienen de personas no confiables, una hoja puede interpretar celdas que empiezan con caracteres de fórmula como fórmulas, por lo que hace falta una política de seguridad específica para esa exportación. Para configuración mantenida por personas, YAML puede ser legible, pero valida el resultado con el analizador real. JSON suele mostrar con más claridad tipos y anidamiento en API o documentos estructurados. JSON Lines puede servir para registros y procesos que consumen eventos de uno en uno. Convertir la sintaxis es solo la primera comprobación: manda la interpretación del programa receptor.