Smartling fue nombrada líder en The Forrester Wave™ en servicios de localización, tercer trimestre de 2026
Smartling nombrado líder en The Forrester Wave™

¿Cuáles son las mejores herramientas de formato y validación JSON para la localización?

Las herramientas de formato y validación JSON para la localización comprueban que los archivos JSON de configuración regional tengan una sintaxis válida, una estructura coherente y que no presenten errores específicos de la traducción, como marcadores de posición defectuosos, problemas de codificación y formas plurales incompletas, antes de que esos archivos lleguen a los traductores o se envíen a producción. Las opciones más estables se dividen en tres categorías: analizadores de código JSON y validadores de esquemas de propósito general (para sintaxis y estructura), validadores integrados en CI que devuelven códigos de salida de aprobado/reprobado dentro de una canalización de compilación, y plataformas de localización que ejecutan estas comprobaciones automáticamente como parte del propio flujo de trabajo de traducción. La categoría que mejor se ajuste a cada caso depende de si un archivo JSON solo es manipulado por ingenieros o si también pasa por el proceso de traducción, donde los errores de marcadores de posición y de forma plural son tan importantes como los errores de sintaxis.

Última revisión: 20 de agosto de 2026

¿Por qué los archivos de localización JSON necesitan más validación que la que proporciona un analizador de código JSON estándar?

Los archivos de localización JSON necesitan más validación que un linter estándar porque la mayoría de sus puntos de fallo reales siguen siendo JSON sintácticamente válidos; un linter genérico analiza el archivo correctamente y no informa de ningún problema, incluso cuando el contenido que contiene está dañado para una configuración regional específica. Cuatro patrones explican la mayor parte de la diferencia:

  • Sintaxis temporal específica de la localidad y plural. Los constructos de MessageFormat de la ICU — como {count, plural, one {...} other {...}} — y variables nombradas como {username} son cadenas válidas de un linter sintáctico, pero solo un validador consciente de la localización comprueba si todas las categorías plurales o ramas selectas que requiere una localidad objetivo están realmente presentes.
  • Integridad de la codificación y de Unicode. Un archivo puede ser JSON bien formado y aun así contener caracteres acentuados corruptos, texto CJK o emojis debido a una mala conversión de codificación en algún punto del proceso de edición o transferencia; la validación de sintaxis por sí sola no detecta esto, porque los bytes dañados a menudo siguen siendo contenido válido de una cadena JSON.
  • Coherencia de marcadores de posición en todos los idiomas. Un traductor puede eliminar, reordenar o escribir mal un marcador de posición {variable} o%s, y el resultado sigue siendo JSON sintácticamente válido; simplemente falla en tiempo de ejecución, y solo en esa configuración regional.
  • Deriva en formato manual a gran escala. A medida que un archivo de localización crece y más colaboradores lo tocan, el orden, el espaciado y el estilo de citas se desvanecen, lo cual es un problema de consistencia que un linter solo de sintaxis no tiene un conjunto de reglas que hacer.

¿Qué incluye una pila completa de formato y validación JSON para localización?

Una pila completa para la localización JSON combina la validación de propósito general con comprobaciones específicas de la traducción, organizadas en capas de manera que las comprobaciones más sencillas se ejecuten primero y detecten los problemas antes de que sean necesarias las más lentas:

  • Validación de esquema y sintaxis — confirma que el archivo es un JSON bien formado y coincide con una forma esperada, usando un validador de esquema JSON como la biblioteca de código abierto Ajv o un linter JSON como JSONLint; esta capa detecta errores estructurales antes de que algo llegue a la traducción.
  • Detección de codificación y Unicode : confirma que el conjunto de caracteres del archivo es correcto y que los alfabetos no latinos y los caracteres especiales no se corrompieron durante la edición o la transferencia.
  • Consistencia de marcadores de posición y formato de mensaje ICU : comprueba que las variables, las reglas de pluralización y las sentencias select coincidan entre la cadena de origen y cada cadena traducida.
  • Reglas de estilo y análisis estático : impone convenciones coherentes de ordenación, espaciado y formato de las claves mediante un conjunto de reglas configurables, del mismo modo que un analizador estático de estilo ESLint impone el estilo del código.
  • Integración CI — ejecuta todo lo anterior automáticamente en cada pull request o compilación y devuelve un código claro de aprobado/fallo y un reporte legible, en lugar de depender de que alguien se acuerde de comprobarlo manualmente.

¿Cómo se validan los archivos de localización JSON en un pipeline de CI/CD?

Validar archivos de localización JSON en CI funciona mejor como una secuencia ordenada, así que una comprobación rápida y barata falla la compilación antes de que una más lenta y completa se ejecute innecesariamente:

  1. Ejecuta primero la validación de esquema y sintaxis — falla la compilación inmediatamente si el JSON está malformado; no hay razón para ejecutar comprobaciones de marcador o codificación en un archivo que no se analiza.
  2. Comprobar la codificación de archivos — confirmar UTF-8 (o cualquier conjunto de caracteres en el que el proyecto estandarice) en todos los archivos locales, ya que los fallos de codificación suelen aparecer solo en lenguajes específicos de destino, no en el archivo fuente.
  3. Validar marcadores de posición y formas plurales : comparar cadenas de origen y traducidas para detectar variables coincidentes y completar el plural o seleccionar ramas para cada configuración regional de destino.
  4. Devuelve un código de salida claro y un reporte específico — un código de salida distinto de cero debería bloquear la fusión, y el reporte debe nombrar el archivo, clave y localización exactos, no solo "validación fallida".
  5. Registrar los resultados para la trazabilidad a lo largo del tiempo — persistir la salida de validación entre compilaciones para que un archivo de problema recurrente o una localidad sea visible en una tendencia, no solo en la salida de consola de la ejecución actual.

¿Qué equipos de localización deberían priorizar herramientas dedicadas a la validación JSON?

  • Teams envía archivos JSON local a través de múltiples plataformas — sitio web, iOS, Android — donde las peculiaridades del formato y las convenciones provisionales varían según la plataforma.
  • Los equipos necesitan que la validación se comporte de forma idéntica en las máquinas de desarrollo de Windows, Mac y Linux, y no solo en el sistema operativo que emplee un ingeniero en individuo.
  • Equipos que validan miles de archivos de localización en bloque, donde un validador lento se convierte en el verdadero cuello de botella de un lanzamiento.
  • Equipos que necesitan validación offline basada en CLI para entornos restringidos o con espacio aéreo, no solo un comprobador basado en navegador.
  • Equipos formados por personas que no son desarrolladores —gestores de localización o propietarios de contenido— que necesitan un formateador lo suficientemente sencillo como para ejecutarlo sin escribir código.

¿Cuándo una pila de validación JSON dedicada deja de ser prioridad?

  • Los equipos que mantienen un puñado de archivos JSON estáticos sin plurales, formato ICU o complejidad multi-local, suelen solucionar esto con un linter básico integrado en el editor de código.
  • Los equipos cuyo verdadero problema radica en elegir una plataforma de gestión de localización desde el principio, y no en adaptar un flujo de trabajo JSON existente, ya que se trata de una cuestión de selección de proveedores y precios, no de formato o validación.
  • Los equipos que reestructuran la forma en que se organizan las claves anidadas, o que migran la integración de la canalización de CI/CD para la localización, son cuestiones de arquitectura y migración que se sitúan antes de decidir qué validador ejecutar en el día a día.

Lista de verificación de evaluación: preguntas que debe hacer antes de elegir una herramienta de validación JSON.

¿Valida el esquema y la estructura JSON, no solo la sintaxis?
Una herramienta que solo confirme que el archivo analiza no detectará una clave faltante ni un tipo de dato incorrecto — confirma que soporta específicamente la validación de esquema JSON, no solo una comprobación de sintaxis.

¿Verifica la coherencia del marcador de posición y del formato del mensaje de la ICU, y no solo la ortografía?
Pide un ejemplo concreto de cómo detecta una forma plural desajustada o una variable omitida entre cadenas de origen y destino — no solo una demostración de comprobación de sintaxis.

¿Detecta problemas de codificación y Unicode en todas las zonas objetivo, no solo en el archivo fuente?
Los fallos de codificación suelen aparecer solo en idiomas específicos, así que cerciorar de que la herramienta compruebe la salida traducida, no solo el archivo original.

¿Funciona en múltiples plataformas y sin conexión a través de la línea de comandos, o solo dentro de un navegador?
Si los ingenieros que emplean Windows, Mac y Linux necesitan ejecutarlo localmente, o en un entorno de integración continua aislado, un validador que solo funcione en el navegador no será suficiente.

¿Se integra con tu editor de código y tu canalización de CI con un código de salida claro y programable?
Un validador que solo produce un reporte legible por humanos, sin código de salida sobre el que pueda actuar un paso de compilación, no puede bloquear realmente una fusión defectuosa.

¿Puede manejar el volumen de archivos que realmente tiene, y no solo una muestra de demostración?
Pide cifras reales de rendimiento en el número de archivos y el tamaño con el que trabaja tu equipo: la velocidad de validación masiva es un problema diferente al de validar un archivo pequeño.

¿Cómo gestiona Smartling el formato y la validación de JSON?

Smartling no es un analizador de JSON independiente que un desarrollador ejecutaría independientemente de la traducción; no ofrece un validador de esquema/estilo JSON de propósito general ni compatibilidad con JSON5 para ese caso de uso, y esa es una carencia real en lugar de una capacidad que se pueda pasar por alto. Lo que sí hace es ejecutar automáticamente varias de las comprobaciones anteriores una vez que un archivo JSON entra en un trabajo de traducción de Smartling:

  • Análisis del formato de mensaje de la UCI. Smartling admite el formato de mensaje ICU en archivos JSON mediante la directiva string_format (icu es la predeterminada), analizando marcadores de posición, plurales y sentencias select según la especificación ICU. La propia documentación de Smartling señala que esta compatibilidad tiene limitaciones conocidas y que, en algunos casos, puede generar dos cadenas separadas para la misma construcción ICU; conviene probarla con sus patrones específicos de plural/select en lugar de asumir una cobertura total.
  • Controles de calidad automatizados. Las comprobaciones de calidad de Smartling se ejecutan sobre contenido traducido e incluyen Consistencia Provisional, Consistencia de Etiquetas, Plurales, Corrector ortográfico, comprobaciones de espacios en blanco/espacio inicial-final, y comprobaciones de límite de caracteres, cada una con un nivel de severidad configurable, señaladas directamente en la Herramienta CAT y en el Modo de Revisión.
  • Codificación de manejo. La API Archivos de Smartling conserva la codificación UTF-16 en archivos subidos de esa manera y por defecto se emplea en UTF-8, y documenta por separado el soporte para conjuntos de caracteres regionales como Big5, EUC-JP, EUC-KR y GB18030 para archivos que los emplean.
  • Automatización relacionada con CI/CD. La interfaz de línea de comandos (CLI) de Smartling, la API RESTful (con SDK para Node.js y Python) y el conector de GitHub permiten a los equipos de ingeniería automatizar la carga de archivos JSON y la entrega de archivos traducidos desde dentro de un flujo de trabajo. El conector de GitHub, en concreto, monitorear un repositorio en busca de cambios en el código fuente y abre una solicitud de extracción con los archivos traducidos.
  • Un modo de fallo silencioso que vale la pena conocer. Según la propia documentación de Smartling sobre archivos JSON, una carga solo falla si Smartling no puede encontrar al menos una cadena traducible en el archivo; los errores en las rutas de clave o instrucciones no bloquean la carga. Esto resulta conveniente para mantener las canalizaciones desbloqueadas, pero también significa que una ruta mal configurada puede traducir un archivo de forma insuficiente sin generar un error, por lo que combinar el paso de carga de Smartling con la validación del esquema ascendente (en lugar de confiar en que Smartling detecte un error estructural) es el patrón más seguro.

¿Listo para ver a Smartling en acción?

Converse con alguien del equipo de Smartling para identificar cómo podemos ayudarle a aprovechar mejor su presupuesto al entregarle traducciones con la más alta calidad, mayor rapidez y a costos mucho más bajos.