Entrecomillar campo CSV

El CSV parece sencillo hasta que un nombre de producto lleva una coma, una nota incluye comillas dobles o una celda ocupa dos líneas. Un campo mal entrecomillado rompe analizadores, hojas de cálculo y canalizaciones de datos de formas difíciles de detectar a posteriori. Úselo cuando necesite un oráculo fiable para una celda —no un analizador CSV completo— antes de ensamblar o dividir filas en otro lugar.

Cómo RFC 4180 entrecomilla un solo campo CSV

RFC 4180 define el CSV como registros de campos separados por comas, con cierre opcional entre comillas dobles para campos que de otro modo serían ambiguos. Un campo que contiene una coma, una comilla doble, un retorno de carro o un salto de línea debe ir entre comillas dobles. Dentro de un campo entrecomillado, una comilla doble literal se escribe como dos comillas dobles seguidas —nunca como escape con barra invertida.

Los campos sin esos caracteres especiales pueden quedar desnudos, aunque los productores pueden entrecomillar todos por uniformidad. Esta capacidad implementa ese contrato para exactamente un token de campo. En modo quote examina el valor en bruto en busca de coma, comilla, CR y LF; si aparece alguno, o si force es true, construye un token entrecomillado envolviendo el texto y sustituyendo cada comilla embebida por un par duplicado.

Si no aparece ninguno y force es false, el valor en bruto se devuelve sin cambios para que los identificadores simples sigan compactos. En modo unquote una comilla doble inicial significa que todo el token está entrecomillado: el carácter final también debe ser comilla doble, cada comilla interior debe aparecer como par, y el cuerpo recuperado se devuelve sin el cierre exterior.

Un token desnudo sin comilla inicial se devuelve tal cual, pero un token desnudo que aún contenga una comilla se rechaza porque esa forma no es un campo sin comillas válido según RFC 4180.

Dónde un entrecomillador de un solo campo CSV rinde

Los generadores de código y trabajos ETL que construyen filas CSV celda a celda deben entrecomillar cada campo de texto libre antes de unir con comas, o un solo título de producto con coma desplazará todas las columnas siguientes. Los ayudantes de importación de hojas y las herramientas de soporte pegan una celda sucia a la vez y necesitan un camino reversible que falle con fuerza ante tickets a medias entrecomillados en lugar de truncar en silencio.

Quienes enseñan higiene de datos quieren una página dedicada al entrecomillado a nivel de campo en lugar de enterrar la regla bajo un limpiador CSV multipista, porque la intención de búsqueda difiere: quien busca entrecomillar o quitar comillas a un campo CSV quiere las reglas de escape, no renombrar columnas ni deduplicar. La validación fallida no consume saldo.

Mantenga cada solicitud en un campo, fije las cadenas de resultado en las pruebas y obtendrá entrecomillado reproducible para generadores, plugins LMS y workers de borde sin arrastrar un marco CSV completo por una sola celda.