Blog

Un controllo i18n per CI che non richiede API key

Il controllo di localize-dev trova copie hardcoded, forme plurali mancanti e traduzioni obsolete, segna la riga nella pull request e non invia nulla da nessuna parte.

Stephen Ufort · 10 novembre 2026 · 2 min di lettura

Una pull request di GitHub in cui il controllo i18n contrassegna una frase hardcoded alla riga 226

Localizzare un’app una volta è la parte facile. La parte difficile è il prossimo rilascio, quando qualcuno aggiunge una frase in inglese e nessuno si accorge che non è tradotta. localize-dev check è un linter per questo. Funziona offline, non richiede account né API key, e termina con codice 1 quando trova un problema, così può fallire un lavoro CI.

Cosa riporta

L'ho eseguito su una piccola app React: un componente, file di localizzazione in inglese, spagnolo e arabo, e una frase che qualcuno ha dimenticato di tradurre. Ecco l'output:

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

La prima scoperta è la frase dimenticata. La seconda è meno ovvia. Il file arabo conteneva files_one e files_other, che sembrano completi se pensi in inglese. L'arabo necessita di sei forme plurali, quindi check segnala le quattro mancanti: zero, two, few e many.

Ogni controllo copre un modo in cui un'app localizzata si interrompe:

  • Testo hardcoded, trovato dallo stesso scanner utilizzato da run.
  • Traduzioni mancanti, contando ogni forma plurale di cui ogni lingua ha bisogno.
  • Traduzioni obsolete: il testo sorgente è cambiato dopo essere stato tradotto, trovato tramite localize.lock.json.
  • Chiavi sconosciute: una chiamata t() la cui chiave non è nel file sorgente, quindi le persone vedrebbero la chiave stessa.
  • Testo che non può essere tradotto dove si trova, con la motivazione.
  • Avvisi che non fanno fallire il lavoro: stili sinistro e destro che si interrompono nelle lingue da destra a sinistra, testo in CSS e chiavi che nessun codice utilizza.

Segnare la riga sulla pull request

Quando viene eseguito in GitHub Actions, check stampa anche comandi del flusso di lavoro, che GitHub mostra come annotazioni sulla differenza della pull request:

::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

Puoi aggiungerlo come passaggio CLI o utilizzare la modalità di controllo della GitHub Action, che non richiede una chiave 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

Perché non invia nulla

check legge solo i file: il tuo sorgente, i tuoi file di localizzazione e il file di blocco. Non effettua chiamate di rete, quindi è sicuro su fork, su codice privato e su runner senza Internet. È anche gratuito e non viene conteggiato nell'allocazione di alcun piano.

Eseguirlo prima della CI

npx localize-dev check --changed esamina solo i file modificati dall'ultimo commit, il che lo rende veloce. npx localize-dev init --agent --pre-commit aggiunge un hook pre-commit di git che controlla i file preparati. Quando un problema è qualcosa che intendevi lasciare, come un nome di marca o del testo in un selettore di lingua, contrassegna l'elemento con data-i18n-ignore o translate="no" e check lo salterà.

Provalo sul tuo codice nell'area di gioco, non è necessario un account