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

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:
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 translateDer 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
runverwendet. - 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_zeroSie können es als CLI-Schritt hinzufügen oder den Check-Modus der GitHub Action verwenden, der keinen API-Schlüssel benötigt:
name: i18n
on: pull_request
jobs:
check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: ufortstephen/autolocalize-action@v1
with:
mode: checkWarum 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