Convertidor JSON a CSV

Acerca del Convertidor JSON a CSV

Convertidor JSON a CSV es una herramienta en línea gratuita que convierte datos JSON (Notación de Objetos JavaScript) a formato CSV (Valores Separados por Comas). Suba un archivo JSON o pegue datos JSON, elija su delimitador CSV y opciones, y descargue el archivo CSV convertido, todo procesado localmente en su navegador para privacidad completa.

¿Cómo manejo JSON anidado al convertir a CSV?

CSV es fundamentalmente plano — cada fila es una secuencia de valores escalares — mientras que JSON permite anidación arbitraria. El convertidor ofrece tres estrategias. El aplanamiento con notación de puntos convierte {"user":{"name":"Alice","age":30}} en columnas user.name y user.age, la opción más común para analítica. El aplanamiento como cadena JSON conserva el objeto anidado como un único valor JSON entrecomillado en una columna, útil cuando quieres ida y vuelta del documento o cargarlo en una base de datos con tipo de columna JSON. La explosión de arreglos (a veces llamada unwind, por el operador $unwind de MongoDB) duplica la fila padre una vez por cada ítem de un arreglo anidado, adecuado cuando cada elemento de arreglo debe volverse su propio registro. Para estructuras profundamente anidadas o recursivas, considera exportar a NDJSON en su lugar — la RFC 4180 nunca fue diseñada para datos jerárquicos y forzarlos siempre pierde información.

¿Qué pasa si mis objetos JSON tienen claves diferentes de un registro a otro?

Este es el problema de heterogeneidad de esquema y es la regla, no la excepción, con JSON de APIs reales. El convertidor escanea cada registro para calcular la unión de todas las claves, luego emite una sola fila de encabezado con cada clave encontrada y escribe un valor vacío en celdas donde un registro particular no tenía valor para esa columna. El resultado es un CSV disperso pero rectangular que cualquier hoja de cálculo e importador SQL puede leer. Si quieres solo las claves presentes en el primer registro (útil cuando registros posteriores tienen campos extra ruidosos que quieres descartar), habilita "Usar esquema del primer registro". Si los registros tienen formas genuinamente incompatibles —digamos, la mitad son usuarios y la mitad son pedidos— divide la entrada en dos pasadas y produce dos CSVs en lugar de forzarlos juntos.

¿Cómo se manejan los arreglos de primitivos como ["red", "green", "blue"]?

Por defecto, un arreglo de primitivos se une en una sola celda con un separador configurable (coma, punto y coma o tubería) — así ["red","green","blue"] se vuelve red;green;blue si eliges punto y coma. Esto mantiene el conteo de filas estable pero hace el análisis posterior en Excel incómodo porque Excel no puede dividir fácilmente una sola celda. La alternativa es la explosión de arreglos: la fila se duplica tres veces con un color por fila, lo que da una tabla ordenada de formato largo familiar para usuarios de Pandas y R. Una tercera opción son columnas de índice: el arreglo se vuelve columnas colors.0, colors.1, colors.2, lo que preserva el orden y es reversible pero desperdicia espacio cuando las longitudes de arreglo varían mucho. Elige la opción que la herramienta posterior — Excel, SQL, dashboard BI — maneje mejor.

¿Por qué Excel arruina caracteres UTF-8 como é, ñ o 中 en mi CSV exportado?

Excel para Windows históricamente abre archivos CSV usando la página de códigos predeterminada del sistema (a menudo Windows-1252 en locales occidentales) en lugar de UTF-8, lo que corrompe cualquier carácter no-ASCII. La solución estándar es anteponer una marca de orden de bytes UTF-8 (EF BB BF) al archivo — este BOM le dice a Excel "interpreta esto como UTF-8" y los caracteres se renderizan correctamente. Este convertidor ofrece una opción "UTF-8 con BOM" en la configuración de salida, activada por defecto por compatibilidad. Excel moderno (365 y 2021+) y todas las versiones de Excel para Mac manejan correctamente UTF-8 sin BOM. Si controlas el flujo del destinatario, prefiere importar mediante el asistente Excel "Datos → Desde texto/CSV" y seleccionar explícitamente la página de códigos 65001 (UTF-8) — esa ruta funciona en cada versión de Excel sin modificar el archivo.

¿Cómo escapa el convertidor valores que contienen comas, comillas o saltos de línea?

El convertidor sigue la RFC 4180 estrictamente. Cualquier campo que contenga el delimitador, una comilla doble o un salto de línea (LF, CR o CRLF) se envuelve en comillas dobles, y cada comilla doble literal dentro del campo se duplica. Por ejemplo, la cadena Ella dijo "ve, ahora" con un salto de línea incrustado se codifica como "Ella dijo ""ve, ahora""\n" con un salto de línea real dentro de las comillas. Esto produce un archivo que va y vuelve fielmente por Excel, Google Sheets, LibreOffice, Pandas read_csv y PostgreSQL COPY — siempre que esos lectores también sigan la RFC 4180, lo que todas las herramientas modernas hacen. Si apuntas a un lector heredado no conforme, puedes cambiar el convertidor al modo "siempre entrecomillar", que envuelve cada campo incondicionalmente y es la configuración más segura para cualquier consumidor desconocido.

¿Puedo elegir qué campos JSON se vuelven columnas CSV y en qué orden?

Sí. Por defecto las columnas aparecen en el orden en que las claves se encuentran por primera vez al recorrer la entrada, pero puedes anular esto completamente. El panel "Selector de columnas" enlista cada clave detectada (con rutas de punto para campos anidados) y permite reordenar arrastrando, ocultar columnas no deseadas y renombrar encabezados sin cambiar la ruta JSON subyacente. También puedes pegar una lista ordenada explícita de columnas desde una plantilla si necesitas que la salida coincida con un esquema existente como un formato de importación posterior. El renombrado es puramente cosmético y la ruta JSON original se preserva internamente, así que reejecutar la conversión en una entrada actualizada produce la misma forma de columna.

¿Cuál es la mejor manera de convertir un archivo JSON de varios GB a CSV?

Cargar un documento JSON de varios GB en un navegador agotará la memoria mucho antes de que el convertidor haga algo útil. El enfoque correcto es conversión por streaming en línea de comandos: jq -r 'paths(scalars) as $p | [($p|join(".")), getpath($p)] | @csv' es una línea única para documentos casi planos, y herramientas como Miller (mlr --ijson --ocsv cat input.json > output.csv), DuckDB (COPY (SELECT * FROM read_json_auto('input.json')) TO 'out.csv' (FORMAT CSV)) y la biblioteca Python ijson recorren el documento evento por evento sin materializarlo. Si la fuente ya es NDJSON (un objeto JSON por línea), simplemente canalízala por Miller o jq línea por línea para escalabilidad casi ilimitada. Usa este convertidor de navegador para documentos hasta unos 50 MB; cambia a streaming en línea de comandos más allá.

¿Cómo preservo tipos de datos JSON como booleanos, nulls y números en el CSV?

CSV no tiene sistema de tipos — cada celda es texto — así que el convertidor elige representaciones textuales. Los booleanos se vuelven las cadenas literales true y false (configurable a 1/0, Sí/No o True/False). Null se vuelve una celda vacía por defecto; muchos importadores SQL tratan celdas vacías como NULL automáticamente, pero puedes optar por emitir la cadena literal null o un centinela como \N (predeterminado de Postgres COPY) si necesitas distinguir cadena vacía de null al importar. Los números se emiten en su forma decimal nativa, lo cual está bien para la mayoría de valores, pero enteros grandes más allá de Number.MAX_SAFE_INTEGER (2^53 − 1) sufren la pérdida de precisión estándar de JavaScript — si tu JSON cita enteros grandes como cadenas ("id": "9007199254740993"), este convertidor preserva la forma de cadena sin cambios y tu sistema posterior puede reanalizarlos con BigInt.