Convertir JSON a CSV: aplanar un arreglo de objetos

Un arreglo JSON de objetos se mapea a una tabla CSV — una fila por objeto, columnas de la unión de claves. El trabajo real está en el entrecomillado y en los valores anidados.

La forma «array de objetos»

CSV es una tabla plana, así que el JSON que se convierte limpiamente es un array de objetos: cada objeto pasa a ser una fila y cada clave una columna.

Construir la cabecera

Usa la unión de las claves de todos los objetos como cabecera, no solo las del primer objeto, para que los registros con claves extra o ausentes sigan alineados. Las celdas que faltan quedan en blanco.

Reglas de entrecomillado

Cualquier valor que contenga una coma, una comilla doble o un salto de línea debe ir entre comillas dobles, y las comillas internas duplicadas, o las columnas se desalinearán.

Valores anidados

Los objetos y arrays no tienen una forma plana en CSV, así que escríbelos como texto JSON dentro de la celda (reversible) o aplánalos en columnas con puntos como address.city.

Orden de cabecera y estabilidad

Ordena la unión de claves o fija el orden al del primer registro y añade las extras al final. Un orden de cabecera estable hace útiles los diffs entre exportaciones y evita que las columnas cambien de sitio en cada ejecución.

Formato de fechas y números

Las hojas de cálculo reinterpretan los valores con bastante agresividad: los IDs numéricos largos pierden precisión, las fechas ISO se reformatean y los ceros a la izquierda desaparecen. Si un valor debe sobrevivir tal cual, entrecomíllalo y, al pegarlo en Excel, antepón un apóstrofo.

Compatibilidad con Excel y Google Sheets

Usa finales de línea CRLF y un BOM (UTF-8 con byte-order mark) para que Excel detecte Unicode. En Google Sheets el BOM es opcional, pero las comas como delimitadores y el escapado con comillas dobles siguen aplicando.

De CSV de vuelta a JSON

Parsea las filas con un split consciente de las comillas (no hagas split por comas a lo bruto), usa la primera fila como nombres de campo y, por columna, intenta convertir números, booleanos y fechas ISO. La ida y vuelta con esta herramienta mantiene las cadenas como cadenas, salvo que una columna sea totalmente numérica.

Errores habituales

Estos son los problemas que rompen la mayoría de las exportaciones CSV.

  • Comas sin escapar dentro de valores de cadena
  • Saltos de línea en celdas sin comillas alrededor
  • Codificaciones mezcladas (UTF-8 frente a Latin-1) que generan mojibake
  • Enteros grandes (IDs) truncados silenciosamente por las hojas de cálculo
  • Booleanos guardados como las cadenas "true"/"false" en lugar de TRUE/FALSE
Open JSON FixCompare JSON changes

Guías de reparación de JSON

Centros temáticos

  1. JSON Parse Errors: Read the Message, Jump to the Fix
  2. Fix Invalid JSON: From 'What's Wrong' to a Clean File
  3. JSON Formatter, Validator, Viewer: Pick the Right Tool
  4. Repair LLM JSON Output: Handling Almost-JSON from AI
  5. Privacy: JSON Tools That Don't Leave Your Browser
  6. JSON Interop: YAML, CSV, XML, JWT, Schema

Guías específicas

  1. Cómo decodificar cadenas Base64 (y payloads JWT)
  2. Codificación URL: codifica parámetros de consulta y rutas
  3. Convertir YAML a JSON (y evitar errores de indentación)
  4. Convertir JSON a XML: raíz, atributos y arreglos
  5. Escapar JSON como literal de cadena (y decodificar JSON con doble codificación)
  6. Arreglar comas finales en JSON
  7. Arreglar comillas simples en JSON
  8. Arreglar claves sin comillas en JSON
  9. Reparar JSON generado por LLM
  10. Arreglar el error de parse JSON: Expected Property Name
  11. JSON frente a literal de objeto JavaScript
  12. Valida el JSON antes de las solicitudes API
  13. Formateador JSON frente a JSON Repair
  14. Arreglar errores JSON Unexpected Token
  15. Convertidor JSON a objeto JavaScript