キーのリネーム

Lingo.dev CLI は翻訳キーのリネームを検出し、既存の翻訳を自動で保持します。キー名だけが変わり、ソース内容が同じままであれば、CLI は既存の翻訳を新しいキーにそのまま適用するため、再翻訳は発生しません。

仕組み#

CLI が比較するのはキー名ではなく、コンテンツのフィンガープリントです。別のキーで同じフィンガープリントが見つかると、CLI はそれをリネームとして認識します。

// locales/en.json (before refactoring)
{
  "welcome_msg": "Welcome to our platform",
  "btn_save": "Save"
}

// locales/es.json (existing translations)
{
  "welcome_msg": "Bienvenido a nuestra plataforma",
  "btn_save": "Guardar"
}

ソースファイル内でキーをリネームした後:

// locales/en.json (after refactoring)
{
  "homepage.welcome": "Welcome to our platform",
  "button.save": "Save"
}

npx lingo.dev@latest run を実行すると、翻訳はそのまま保持されます:

// locales/es.json (translations carried forward)
{
  "homepage.welcome": "Bienvenido a nuestra plataforma",
  "button.save": "Guardar"
}

検出ルール#

次の条件を満たすと、キーのリネームとして検出されます:

• キー名が変更されている
• ソース内容が完全に同一である
• キーが同じバケット内に存在する

次の場合、キーのリネームとしては検出されません:

• キーと内容の両方が同時に変更される（新しいキーとして扱われる）
• 内容だけが変更される（内容の更新として扱われ、再翻訳が行われる）

大規模なリファクタリング#

リネーム検出は、どんな規模でも機能します。フラットなキーからネストされた名前空間まで、キー構造全体を再編成しても、CLI は一致する翻訳を 1 回の実行ですべて引き継ぎます。

次のステップ#