Übersetzungsschlüssel, die in einer ganzen App konsistent bleiben
Wie localize.dev Schlüssel benennt, sie für wiederholten Text wiederverwendet, kurze, mehrdeutige Texte trennt und bemerkt, wenn sich Quelltext nach der Übersetzung ändert.
Stephen Ufort · 6. November 2026 · 2 Min. Lesezeit

Handgeschriebene Schlüssel driften ab. Eine Person schreibt save_button, eine andere buttons.save, eine dritte common.actions.save, und drei Schlüssel enthalten dasselbe Wort. Wenn ein Coding-Agent aufgefordert wird, Strings einzeln zu extrahieren, driftet es auf die gleiche Weise, da jede Datei beginnt, ohne die Schlüssel zu kennen, die die anderen erstellt haben.
localize.dev benennt Schlüssel für die gesamte App in einem Durchlauf und merkt sie sich für den nächsten Durchlauf. Dieser Beitrag erklärt, wie.
Wer benennt den Schlüssel
Das Modell schlägt jeden Schlüssel aus dem Dateipfad, der Komponente und dem String vor. Die Regeln, die es erhält, sind kurz: Kleinbuchstaben-Snake-Case-Segmente, die durch Punkte verbunden sind, ein Namespace für das Feature oder den Bildschirm und ein Name für das, was der String tut, keine Transliteration davon. src/components/AuthForm.tsx gibt auth.*; eine Überschrift wird zu auth.welcome_heading, nicht zu auth.welcome_back_we_missed_you.
Alles danach ist Code. Jeder vorgeschlagene Schlüssel wird bereinigt und registriert. Wenn zwei verschiedene Strings denselben Namen erhalten, erhält der zweite ein _2-Suffix, und ein Schlüssel, der mit einem vorhandenen Zweig der Lokalisierungsdatei kollidieren würde, wird umbenannt, sodass keiner den anderen überschreibt.
Derselbe Text erhält denselben Schlüssel
Bevor ein String an das Modell gesendet wird, prüft die Engine, ob der Text bereits einen Schlüssel hat, entweder in Ihrer Quellsprachdatei oder von früher im selben Durchlauf. Wenn ja, ruft der Code diesen Schlüssel erneut auf und das Modell sieht den String nie. Ein Durchlauf meldet diese als wiederverwendete Schlüssel und zählt jeden Ort, an dem der Text erscheint. Zehn „Abbrechen“-Schaltflächen sind also zehn Wiederverwendungen eines Schlüssels.
Kurze Texte, die zwei Dinge bedeuten
Wiederverwendung nur nach Text ist falsch für kurze Texte. „Posten“ auf einem Button ist ein Verb, und in einem Kartentitel ist es ein Substantiv. Viele Sprachen verwenden für jedes unterschiedliche Wörter.
Eine Kopie von drei Wörtern oder weniger, bis zu 40 Zeichen, ohne Platzhalter oder Tags, erhält eine Bedeutung neben ihrem Text: das Element und das Attribut, in dem sie sitzen, wie button oder input[placeholder]. "Post" auf einem <button> und "Post" in einem <h3> werden zu separaten Nachrichten, jede mit einem Hinweis auf ihren Ort.
"placeholder" attribute on <input> in component <Login>
element text inside <button> in component <Composer>Wenn die Übersetzungen der beiden Bedeutungen in allen Sprachen gleich zurückkommen, verschmelzen sie wieder zu einem Schlüssel. Wenn sie unterschiedlich sind, bleiben beide Schlüssel bestehen. Du erhältst nur dann einen zweiten Schlüssel, wenn eine Sprache tatsächlich einen braucht.
Wissen, wann sich der Quelltext geändert hat
Schlüssel helfen nur, wenn ihre Übersetzungen mit der Quelle Schritt halten. Wenn jemand "Speichern" in en.json in "Änderungen speichern" ändert, sind alle Übersetzungen dieses Schlüssels veraltet, aber im Datei steht nichts dazu.
localize.lock.json speichert einen Fingerabdruck jeder Quellmeldung zum Zeitpunkt ihrer Übersetzung: die ersten 12 hexadezimalen Zeichen ihres SHA-256. Committe es mit deinem Code. Beim nächsten Lauf wird eine Nachricht, deren Fingerabdruck nicht mehr übereinstimmt, erneut übersetzt, und localize-dev check schlägt in CI mit einem "Veraltete Übersetzungen"-Fehler fehl, der die Schlüssel nennt.
Schlüssel in anderen Stapeln
Nicht jeder Stack verwendet Punkt-Schlüssel. Laravel’s JSON-Dateien und gettext-Kataloge verwenden den Quelltext selbst als Schlüssel, also tut es localize.dev auch. Flutter’s ARB-Schlüssel sind camelCase und Android’s sind snake_case, weil das ihre Tools erwarten.
Probieren Sie es mit Ihrem eigenen Code im Playground aus, kein Konto erforderlich