JSON a CSV

Ejemplo

Entrada:

[
  { "id": 1, "user": { "name": "Alice", "email": "a@a.com" }, "tags": ["admin"] },
  { "id": 2, "user": { "name": "Bob",   "email": "b@b.com" }, "tags": ["user", "beta"] }
]

Salida (aplanar anidados, unir arreglos):

id,user.name,user.email,tags
1,Alice,a@a.com,admin
2,Bob,b@b.com,"user,beta"

Elección de delimitador

Reglas de comillas

Un campo debe estar entre comillas cuando contiene:

• el delimitador
• una comilla doble (que se escapa duplicando: " -> "")
• un salto de línea

“Siempre citar” es más seguro para la compatibilidad entre herramientas; “citar solo cuando sea necesario” hace que el archivo sea más fácil de leer manualmente.

Manejo de objetos anidados

• Aplanar: { user: { name: "A" } } se convierte en una columna user.name. Rutas profundas se convierten en a.b.c.d.
• Cadena JSON: el objeto anidado se mantiene como un valor JSON de una sola columna: "{\"name\":\"A\"}". Útil cuando las herramientas posteriores pueden analizarlo.
• Convertir a cadena: une con un separador, perdiendo la estructura.

Manejo de arreglos

• Unir: ["a", "b"] se convierte en "a,b" en una sola columna.
• Columnas indexadas: produce tags.0, tags.1, tags.2, solo funciona cuando la longitud del arreglo es consistente.
• Solo primer elemento: toma tags[0] e ignora el resto.

Errores comunes

• Claves desiguales entre objetos. Si un objeto tiene phone y otro no, el CSV obtiene una columna phone con celdas vacías para las filas faltantes. Siempre valida que el conjunto de claves sea consistente.
• Olvidar BOM para Excel. Excel en Windows lee CSVs UTF-8 sin BOM como Latin-1 y distorsiona caracteres acentuados. La herramienta ofrece un interruptor de “prefijo UTF-8 BOM” para ese caso.
• Incrustar saltos de línea en valores. Legal en CSV RFC 4180, pero algunos importadores se bloquean. Si tu objetivo es frágil, reemplaza \n con un espacio o token \\n.
• Usar Excel como formato de ida y vuelta. Excel convierte silenciosamente 007 a 7, trunca números largos y corrompe ceros a la izquierda en IDs. Para la integridad de los datos, usa CSV con un analizador adecuado.