Desarrollo

Por qué un CSV se abre en una sola columna o con acentos rotos

Fallan dos suposiciones distintas: qué carácter separa los campos y en qué codificación están los bytes. Cómo distinguir los síntomas y qué hacer con cada uno.

Una sola caja ancha con divisores punteados que nunca se aplicaron, una flecha debajo y la misma fila partida en celdas por un punto y coma.

Un CSV se abre en una sola columna cuando el programa separa los campos con un carácter distinto del que usa el archivo: el archivo trae punto y coma y el programa espera comas, o al revés. Los acentos que se vuelven é o � son otro problema aparte, el programa lee los bytes con una codificación distinta de aquella en que se guardó el archivo. Ninguno de los dos es un daño del archivo. Cada uno es una suposición que el programa hizo sin preguntarte, y un CSV no trae ningún campo que diga cuál es la correcta.

¿Por qué mi CSV se abre en una sola columna?

Un CSV es texto con un separador entre los campos, y el formato no dice cuál es ese carácter. El RFC 4180, el memorando de 2005 que describió la práctica común, usa la coma, pero es informativo y muchísimos archivos reales usan otra cosa. La alternativa habitual es el punto y coma, y el motivo es regional: en muchos países la coma es el separador decimal, así que 3,50 es un número y la coma no puede separar también los campos.

Entonces la hoja de cálculo tiene que elegir. La documentación de Microsoft dice que el separador de listas predeterminado al guardar un CSV en Excel es la coma, que se controla desde la configuración regional de Windows y que Excel usa punto y coma cuando el separador decimal está puesto en coma. Abrir un archivo con doble clic aplica lo que tenga configurado tu propia computadora, no lo que tenía la de quien lo envió. Un archivo con punto y coma de un colega en Madrid se abre como una columna ancha en una máquina configurada con coma, y un archivo con comas se abre como una columna ancha en una máquina configurada con punto y coma.

La solución es dejar de permitir que el programa adivine. En Excel, Datos y luego Desde texto/CSV muestra una vista previa y te deja elegir el delimitador, y la misma documentación indica que cambiar el nombre del archivo a .txt abre el asistente de importación anterior. Google Sheets y LibreOffice también preguntan cuando importas en lugar de abrir. Excel respeta desde hace mucho una primera línea que diga sep=; como instrucción, pero es una convención de un solo programa: cualquier otro lector la trata como una fila de datos, así que no la dejes en un archivo que vaya a leer un script.

¿Por qué los acentos se convierten en é o �?

El texto en disco son bytes, y la codificación es la tabla que los convierte de nuevo en letras. La mayoría de los archivos de hoy están en UTF-8, donde é ocupa dos bytes. El software antiguo de Windows suele usar por omisión una codificación heredada de un solo byte, como Windows-1252, donde é ocupa uno. Los mismos bytes leídos con la tabla equivocada dan dos patrones reconocibles:

Que Excel adivine bien el UTF-8 depende de la versión y de la plataforma, y no he probado todas las versiones, así que toma esto como el patrón y no como una regla sobre la tuya. Lo que lleva años siendo fiable es que un archivo UTF-8 que empieza con un byte order mark se reconoce como UTF-8, y que uno sin esa marca puede leerse con la página de códigos del sistema. La marca es el mismo carácter invisible que explica los caracteres invisibles en un texto: inofensivo para una hoja de cálculo y molesto para un script que no lo quita.

El camino seguro vuelve a ser el explícito. En Desde texto/CSV, cambia el origen del archivo a UTF-8 y la vista previa debería corregirse antes de que cargues nada.

¿Cómo distingo cuál de los dos problemas tengo?

Mira cuál es el síntoma, no el archivo.

Lo que vesLa causaLa solución
Cada fila es una sola celda, con comas o puntos y coma a la vistaDelimitador distintoImporta y elige el delimitador
Las columnas se parten donde no deben, números como 3,50 cortados en dosLa coma hace de decimal y de separador a la vezImporta con punto y coma como delimitador
é, ’ donde van letrasUTF-8 leído como codificación heredadaImporta y elige UTF-8 como origen del archivo
� donde van letrasArchivo heredado leído como UTF-8Ábrelo como Windows-1252 o Latin-1 y guárdalo como UTF-8
El encabezado de la primera columna se ve bien, pero una búsqueda por él fallaByte order mark al comienzoQuítalo, o vuelve a guardar sin él

Una advertencia sobre la fila de �. Cuando un archivo se abrió con la codificación equivocada y se volvió a guardar, las letras originales se perdieron para siempre y ningún ajuste las recupera. Vuelve a la descarga original, no a tu copia editada.

¿Qué resuelve el conversor de aquí y qué no puede hacer?

El conversor de CSV a JSON se ocupa del delimitador y no de la codificación, y la diferencia sale de cómo funciona. Lee las primeras cinco líneas y elige, entre coma, punto y coma, tabulación y barra vertical, el carácter que divide todas ellas en la misma cantidad de campos. Puedes cambiarlo desde el menú de delimitador, algo que conviene hacer cuando la fila de encabezado trae comas dentro de sus nombres o las primeras líneas son muy cortas. Un resultado de una sola columna ahí suele significar que la suposición fue equivocada.

No puede reparar la codificación. El texto pegado en el cuadro ya fue decodificado por el programa del que lo copiaste, así que si muestra José el daño ocurrió antes de que llegara. Un archivo elegido con el selector lo lee el navegador como UTF-8 y no hay forma de escoger otra codificación, así que un archivo en Windows-1252 mostrará el carácter de reemplazo en lugar de sus acentos. En los dos casos la respuesta es volver a abrir el original en un programa que te deje elegir la codificación, guardarlo como UTF-8 y regresar. Un byte order mark al comienzo se elimina antes de analizar, así que no se pegará a tu primera clave.

El conversor tampoco sirve para un archivo que no se pueda leer como texto. Un .xlsx de verdad es un paquete comprimido, no texto delimitado, y hay que exportarlo a CSV primero. En ningún caso se sube nada; la página lee el archivo. Para lo que pasa con los ceros a la izquierda, las fechas y los datos anidados una vez que el delimitador está bien, cómo convertir CSV a JSON y qué se rompe continúa donde este termina.

¿Cómo escribo un CSV que se abra bien en todas partes?

No puedes lograr que un archivo sea correcto para todos los programas, pero sí reducir las suposiciones. Guarda en UTF-8, y añade un byte order mark solo si quienes lo abrirán usan Excel y has visto que les desfigura los acentos. Elige un solo delimitador e indica cuál en el nombre del archivo o en el mensaje que lo acompaña. Si los datos tienen comas decimales, el punto y coma evita el choque. Si va a un script o a otro sistema y no a una persona con una hoja de cálculo, la coma sin marca es la opción más simple, y JSON es el formato mejor cuando la estructura es más que filas planas. La guía de JSON a CSV cubre el camino inverso y lo que cuesta aplanar.

Si un archivo se abre en una sola columna, pégalo en el conversor de CSV a JSON y lee la nota debajo de la salida: indica qué delimitador usó, y puedes cambiarlo desde el menú. Corre en tu navegador, así que los datos se quedan en tu máquina.

Para saber qué vigilar una vez que las columnas están bien, cómo convertir CSV a JSON y qué se rompe cubre los tipos, los ceros a la izquierda y las fechas.

Preguntas frecuentes

¿Por qué mi CSV se abre en una sola columna en Excel?

Excel separa los campos con el separador de listas de la configuración regional de tu computadora, y el archivo usa otro carácter, normalmente un punto y coma donde Excel espera una coma o al revés. Usa Datos y luego Desde texto/CSV, y elige el delimitador en la vista previa en lugar de abrir el archivo con doble clic.

¿Por qué mi CSV muestra é en lugar de é?

El archivo está guardado en UTF-8 y el programa lo lee como una codificación heredada de un byte, como Windows-1252, así que cada letra con acento se convierte en dos o tres caracteres equivocados. Vuelve a importar el archivo y elige UTF-8 como origen. El archivo en sí no tiene nada malo.

¿Por qué algunos CSV usan punto y coma en vez de coma?

En los países donde la coma es el separador decimal, un número como 3,50 chocaría con una coma entre campos, así que las hojas de cálculo de allí escriben punto y coma. El RFC 4180 describe la coma, pero es informativo y los archivos reales varían, y por eso un buen lector te deja elegir el delimitador.

¿Puede el conversor de CSV a JSON arreglar los acentos rotos?

No. Cuando el texto llega al cuadro ya fue decodificado, así que no puede saber cuál era la codificación original, y un archivo elegido con el selector se lee solo como UTF-8. Sí detecta el delimitador a partir de las primeras cinco líneas y elimina un byte order mark inicial. Arregla la codificación en el programa que abrió el archivo.

¿Puedo recuperar los acentos rotos después de guardar el archivo?

Normalmente no. Si un archivo se abrió con la codificación equivocada y se volvió a guardar, los caracteres originales fueron reemplazados y ningún ajuste los recupera. Vuelve a la descarga o exportación original, ábrela con la codificación correcta y guarda una copia en UTF-8.

Última actualización 6 de noviembre de 2026