Blog

Una comprobación de i18n para CI que no requiere clave API

La comprobación de localize-dev encuentra copias codificadas, formas plurales faltantes y traducciones obsoletas, marca la línea en la solicitud de extracción y no envía nada a ningún lado.

Stephen Ufort · 10 de noviembre de 2026 · 2 min de lectura

Una solicitud de extracción de GitHub donde la verificación i18n marca una oración codificada en la línea 226

Localizar una app una vez es la parte fácil. La parte difícil es la próxima versión, cuando alguien añade una frase en inglés y nadie nota que no está traducida. localize-dev check es un linter para eso. Funciona sin conexión, no necesita cuenta ni clave API, y sale con código 1 cuando encuentra un problema, para que pueda fallar un trabajo de CI.

Lo que informa

Lo ejecuté en una pequeña aplicación React: un componente, archivos de idioma en inglés, español y árabe, y una oración que alguien olvidó traducir. Aquí está la salida:

npx localize-dev check
  src/components/SignIn.tsx:9  "We'll email you a 6-digit code. No password needed."
⚠️  1 hardcoded string(s) in 1 file(s). Fix with: npx localize-dev run
⚠️  ar: 4 message(s) without a translation in locales/ar.json
Fill them in with: npx localize-dev translate

El primer hallazgo es la frase olvidada. El segundo es menos obvio. El archivo árabe tenía files_one y files_other, lo que parece completo si piensas en inglés. El árabe necesita seis formas plurales, por lo que check informa las cuatro que faltan: zero, two, few y many.

Cada verificación cubre una forma en que una aplicación localizada falla:

  • Texto codificado, encontrado por el mismo escáner que usa run.
  • Traducciones faltantes, contando cada forma plural que cada idioma necesita.
  • Traducciones obsoletas: el texto fuente cambió después de ser traducido, encontrado a través de localize.lock.json.
  • Claves desconocidas: una llamada a t() cuya clave no está en el archivo fuente, por lo que la gente vería la clave en sí.
  • Texto que no se puede traducir donde está, con el motivo.
  • Advertencias que no fallan el trabajo: estilos de izquierda y derecha que fallan en idiomas de derecha a izquierda, texto en CSS y claves que ningún código utiliza.

Marcando la línea en la solicitud de extracción

Cuando se ejecuta en GitHub Actions, check también imprime comandos del flujo de trabajo, que GitHub muestra como anotaciones en la diferencia de la solicitud de extracción:

::error file=src/components/SignIn.tsx,line=9,title=Hardcoded string::"We'll email you a 6-digit code. No password needed." isn't translated. Run localize-dev run (or let the Action open a pull request).
::error file=locales/ar.json,title=Missing ar translations::4 message(s) have no ar translation: signin.files_few, signin.files_many, signin.files_two, signin.files_zero

Puedes añadirlo como un paso de CLI, o usar el modo de verificación de la GitHub Action, que no requiere una clave API:

.github/workflows/i18n.yml
name: i18n
on: pull_request
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: ufortstephen/autolocalize-action@v1
        with:
          mode: check

Por qué no envía nada

check solo lee archivos: tu código fuente, tus archivos de localización y el archivo de bloqueo. No realiza llamadas de red, por lo que es seguro en forks, en código privado y en runners sin conexión a internet. También es gratuito y no cuenta para la asignación de ningún plan.

Ejecutándolo antes de CI

npx localize-dev check --changed solo mira los archivos modificados desde el último commit, lo que lo mantiene rápido. npx localize-dev init --agent --pre-commit añade un hook de pre-commit de git que comprueba los archivos preparados. Cuando un problema es algo que pretendías dejar, como un nombre de marca o texto en un selector de idioma, marca el elemento con data-i18n-ignore o translate="no" y check lo omitirá.

Pruébalo en tu propio código en la zona de juegos, no se necesita cuenta