Blog

Ein i18n-Check für CI, der keinen API-Schlüssel benötigt

Der localize-dev-Check findet hardcodierten Text, fehlende Pluralformen und veraltete Übersetzungen, markiert die Zeile im Pull-Request und sendet nichts irgendwohin.

Stephen Ufort · 10. November 2026 · 2 Min. Lesezeit

Ein GitHub Pull Request, bei dem die i18n-Prüfung einen hartcodierten Satz in Zeile 226 markiert

Das einmalige Lokalisieren einer App ist der einfache Teil. Der schwierige Teil ist die nächste Version, wenn jemand einen Satz auf Englisch hinzufügt und niemand bemerkt, dass er nicht übersetzt wurde. localize-dev check ist ein Linter dafür. Es läuft offline, benötigt kein Konto und keinen API-Schlüssel, und beendet sich mit Code 1, wenn es ein Problem findet, sodass es einen CI-Job fehlschlagen lassen kann.

Was es berichtet

Ich habe es auf einer kleinen React-App ausgeführt: eine Komponente, englische, spanische und arabische Sprachdateien und ein Satz, den jemand vergessen hat zu übersetzen. Hier ist die Ausgabe:

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

Der erste Fund ist der vergessene Satz. Der zweite ist weniger offensichtlich. Die arabische Datei enthielt files_one und files_other, was vollständig aussieht, wenn man auf Englisch denkt. Arabisch benötigt sechs Pluralformen, daher meldet check die vier fehlenden: zero, two, few und many.

Jede Prüfung deckt eine Art ab, wie eine lokalisierte App fehlschlägt:

  • Fest codierter Text, gefunden vom selben Scanner, den run verwendet.
  • Fehlende Übersetzungen, die jede Pluralform zählen, die jede Sprache benötigt.
  • Veraltete Übersetzungen: Quelltext wurde nach der Übersetzung geändert, gefunden durch localize.lock.json.
  • Unbekannte Schlüssel: Ein t()-Aufruf, dessen Schlüssel nicht in der Quelldatei vorhanden ist, sodass die Leute den Schlüssel selbst sehen würden.
  • Text, der nicht übersetzt werden kann, wo er sich befindet, mit Angabe des Grundes.
  • Warnungen, die den Job nicht fehlschlagen lassen: Links- und Rechtshänder-Stile, die in Rechts-nach-links-Sprachen fehlschlagen, Text in CSS und Schlüssel, die kein Code verwendet.

Die Zeile im Pull Request markieren

Wenn es in GitHub Actions ausgeführt wird, gibt check auch Workflow-Befehle aus, die GitHub als Annotationen im Diff des Pull Requests anzeigt:

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

Sie können es als CLI-Schritt hinzufügen oder den Check-Modus der GitHub Action verwenden, der keinen API-Schlüssel benötigt:

.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

Warum es nichts sendet

check liest nur Dateien: Ihre Quelldateien, Ihre Lokalisierungsdateien und die Lock-Datei. Es tätigt keine Netzwerkaufrufe, daher ist es sicher auf Forks, auf privatem Code und auf Runnern ohne Internet. Es ist auch kostenlos und zählt nicht zur Freigabe eines Plans.

Ausführung vor CI

npx localize-dev check --changed betrachtet nur Dateien, die seit dem letzten Commit geändert wurden, was es schnell macht. npx localize-dev init --agent --pre-commit fügt einen Git-Pre-Commit-Hook hinzu, der die gestagten Dateien überprüft. Wenn ein Problem etwas ist, das Sie beibehalten möchten, wie z. B. ein Markenname oder Text in einer Sprachauswahl, markieren Sie das Element mit data-i18n-ignore oder translate="no" und check überspringt es.

Probieren Sie es mit Ihrem eigenen Code im Playground aus, kein Konto erforderlich