CSV y JSON resuelven problemas distintos

CSV es simple, tabular y fácil de abrir en hojas de cálculo.
JSON funciona mejor para datos estructurados como respuestas de API, configuraciones, arreglos y objetos anidados.

Convertir CSV y JSON: cómo elegir el formato correcto para APIs y migraciones

Convertir entre ambos formatos facilita entregas entre equipos, importaciones masivas, pruebas de API y limpieza de datos.

Convertir CSV a JSON

Usa la fila de cabecera como claves

Muchos archivos CSV empiezan con cabeceras como name,email,role.
Al convertir a JSON, esas cabeceras suelen transformarse en claves del objeto.

[
  { "name": "Alice", "email": "alice@example.com", "role": "admin" }
]

Revisa el delimitador

No todos los archivos tipo CSV usan comas.
Algunos exportes usan tabulaciones o punto y coma.
Si las columnas no se separan bien, revisa primero el delimitador.

Ten cuidado con los tipos

En CSV, muchos valores se tratan como texto.
Después de convertir a JSON, confirma si identificadores, códigos postales o teléfonos deben seguir siendo cadenas aunque parezcan números.

Convertir JSON a CSV

JSON se convierte mejor a CSV cuando es un arreglo de objetos con claves similares.
Si hay objetos anidados o arreglos, puedes aplanarlos con claves como profile.name, guardarlos como texto en una celda o excluir campos que no sean útiles en una tabla.

Para hojas de cálculo e importaciones, un conjunto pequeño y estable de columnas suele ser más práctico.

Ejemplo: convertir un array de objetos en CSV

Con un JSON como este,

[
  { "id": 1, "name": "Alice", "role": "admin" },
  { "id": 2, "name": "Bob", "role": "member" }
]

si todos los objetos tienen las mismas claves, basta con asignar las claves a la fila de encabezado y los valores a cada fila para obtener el CSV.

id,name,role
1,Alice,admin
2,Bob,member

A la inversa, si las claves varían de un objeto a otro (por ejemplo, uno no tiene role), las columnas se desplazan. Comprobar de antemano que todos los registros tienen la misma forma evita accidentes.

Trampas del escape y de la codificación de caracteres

El CSV parece simple, lo que también lo hace fácil de romper según los valores. En la práctica, dos cosas suelen hacer tropezar.

Valores con comas, saltos de línea o comillas

Si un valor contiene una coma o un salto de línea, las columnas se desplazan a menos que lo escapes encerrándolo entre comillas. El RFC 4180 indica encerrar el valor entre "..." y duplicar cada " interior como "".

id,note
1,"Hello, world"
2,"Una nota
en dos líneas"
3,"Dijo ""OK"""

Comprueba si tu herramienta de conversión o biblioteca hace este escape automáticamente. Si unes cadenas a mano, casi seguro caerás en esta trampa.

Codificación de caracteres y BOM

Abrir en Excel un CSV con japonés puede mostrar texto ilegible. Ocurre porque Excel confunde UTF-8 con Shift_JIS, y guardarlo como UTF-8 con BOM permite abrirlo correctamente en muchos entornos. A la inversa, un programa que lee el archivo puede necesitar quitar el BOM o la primera clave saldrá desplazada, así que elige según el uso.

Conversión con DevToolKits

El convertidor CSV ⇔ JSON permite convertir en ambos sentidos y ajustar delimitadores y cabeceras.
Después puedes revisar el resultado con el formateador JSON o convertirlo con el conversor JSON ⇔ YAML si necesitas usarlo como configuración.

Preguntas frecuentes

Los números del CSV se vuelven numéricos en JSON. ¿Cómo los mantengo como cadenas?

Valores como códigos postales, identificadores y teléfonos que “parecen números pero deben ser cadenas” pueden perder ceros iniciales o desbordarse si se convierten a números. Usa una opción de “tratar como cadena” durante la conversión si está disponible, o revisa y corrige el tipo de esos campos después de convertir.

¿Puedo convertir JSON anidado a CSV?

CSV es un formato plano y tabular, así que los objetos y arreglos anidados no caben en una sola celda tal cual. Aplana claves como profile.name, o reduce a solo los campos que necesitas antes de convertir a CSV.

Mis columnas se desalinean aunque está separado por comas.

Si un valor contiene una coma o un salto de línea, las columnas se desplazarán a menos que esté correctamente escapado con comillas ("..."). Además, un archivo llamado “CSV” puede estar separado por tabulaciones o punto y coma. Revisa el delimitador y la configuración de comillas.

El japonés se ve ilegible al abrirlo en Excel.

Excel puede confundir un CSV en UTF-8 con Shift_JIS, lo que deforma el texto japonés. Guardarlo de nuevo como UTF-8 con BOM lo muestra correctamente en muchos entornos. A la inversa, cuando lees el archivo desde un programa, el BOM puede colarse como un carácter extra, así que quítalo en el lado de lectura.

¿Puedo convertir en CSV un JSON con claves inconsistentes?

Cuando las claves difieren entre registros, puedes combinarlos en un solo CSV usando la unión de todas las claves como encabezado y dejando vacíos los valores que faltan. Las columnas se multiplican y resulta difícil de ver, así que recomendamos unificar antes la forma de los datos o limitarse a los campos necesarios.