Автор:
    Создание:2026-06-13Последнее обновление:2026-06-13

    Миграция с Lingui на Intlayer

    Если ваш проект в настоящее время полагается на компиляцию на основе макросов Lingui, переход на Intlayer позволяет вам сохранить мощные рабочие процессы макросов, поддерживая их изначально стратегией компиляции JSON Intlayer.

    Что делать

    Чтобы начать, инициализируйте Intlayer в вашем проекте:

    bash
    npx intlayer init

    Это создает ваш intlayer.config.ts. Убедитесь, что вы сохранили @lingui/babel-plugin-lingui-macro / @lingui/swc-plugin в вашем шаге сборки для запуска перед компилятором Intlayer. Затем используйте псевдоним плагина bundler для маршрутизации @lingui/core и @lingui/react на @intlayer/lingui.

    Что происходит под капотом

    Lingui использует макросы (такие как t`Hello ${name}` и <Trans>), которые компилируются в вызовы runtime, такие как i18n._(id, values).

    Под капотом:

    • Макросы: Они компилируются точно так же, как и раньше, обеспечивая отсутствие нарушений в синтаксисе вашего исходного кода.
    • Перевод runtime: Aliased i18n._() использует словари Intlayer. Как явно названные ID, так и хешированные ID полностью отображаются с использованием плагинов синхронизации .po Intlayer для безопасного агрегирования и обрезки ключей.
    • Возможности ICU: Поддержка множественного числа, выбора и вариантов ICU остается надежной благодаря унифицированному парсеру ICU Intlayer, обеспечивающему идентичные выходные данные отображения.