Устарел ли i18next в 2026 году?

i18next появился в 2011 году, задолго до того, как компоненты React, сборка через Webpack или TypeScript стали общепринятым стандартом. Он завоевал экосистему благодаря гибкости и повсеместности, получив плагины под любой стек и ответы на StackOverflow на каждый вопрос.

Проект не заброшен, обновления и патчи выходят регулярно. Однако есть существенная разница между поддержанием работоспособности старого движка и активной адаптацией к современным архитектурам фронтенда.

За последние годы фронтенд перешел к компиляции на этапе сборки, React Server Components (RSC), агрессивному tree-shaking и процессам на базе ИИ. Ядро i18next остается тем же, что и десять лет назад: синглтон времени выполнения, сопоставляющий строковые ключи на стороне клиента.

Главные выводы

Режим поддержки:

За прошедший год next-i18next получил ~63 коммита (примерно один в неделю), а react-i18next ~157, в основном для обновления зависимостей и мелких правок.

Ощутимый runtime-оверхед:

react-i18next и next-i18next добавляют ~17–18 КБ gzipped (~60 КБ minified) еще до рендеринга первого переведенного слова, что почти в 4 раза тяжелее next-intlayer (~4.7 КБ).

Серьезная утечка данных:

При стандартных статических конфигурациях до 89.8% объема переводов, передаваемых на страницу, относится к другим маршрутам или неиспользуемым языкам.

Невозможность tree-shaking:

Динамические вызовы вроде t("home.hero.title") не поддаются статическому анализу бандлеров, вынуждая включать полные JSON-файлы в клиентский бандл.

Коммерческие приоритеты:

Создатели развивают Locize. Интеграция бесплатного локального ИИ-перевода напрямую в CLI напрямую конкурировала бы с их основным источником дохода.

Поддержка vs. активная эволюция

Количество звезд на GitHub отражает историческую популярность, а не актуальность архитектуры.

Показать все данные таблицы

Показать все данные таблицы

Открыть таблицу в модальном окне для четкого просмотра всех данных

Репозиторий	Звезды	Всего коммитов	Коммитов / год	Последний коммит
i18next/i18next
i18next/react-i18next
i18next/next-i18next
aymericzip/intlayer

Активность за прошедшие 12 месяцев:

Компактная библиотека может быть стабильной, но инструменты локализации не стоят на месте: сборщики удаляют неиспользуемый контент во время сборки, языковые модели переводят прямо в CI, а среды разработки используют Language Server (LSP) и ИИ-агентов. Ограниченная временем выполнения архитектура i18next затрудняет внедрение этих инноваций.

Чтобы понять, откуда взялись эти библиотеки, прочитайте историю i18n в JavaScript.

Загрузки npm

Число загрузок вознаграждает самые старые решения, а не лучшие. Библиотеку, выпущенную много лет назад, до сих пор устанавливает каждый проект, который выбрал её тогда, каждый запуск CI и каждый зависящий от неё пакет. Эта цифра измеряет инерцию, а не осознанный выбор.

ИИ-ассистенты усиливают этот эффект. next-intl, i18next и vue-i18n повсюду встречаются в коде, на котором они обучались, поэтому ассистенты предлагают их по умолчанию, не сравнивая альтернативы. Каждая подсказка добавляет загрузки, которые подпитывают следующую. Сравнивайте по бенчмарку, а не по числу загрузок.

Оценка влияния на бандл

Измерения в production-сборке на 10 маршрутах и 10 языках со сжатием gzip. Подробности в отчете о бенчмарке i18n.

Базовый оверхед библиотек

Размер до добавления переведенного текста:

Вес страницы и утечка контента

Тестирование на React / TanStack Start (статическая стратегия):

В Next.js:

Ключевые результаты

Вес страниц:

В Next.js next-i18next добавляет 76.7 КБ gzipped к базовому приложению (+50%). next-intlayer добавляет лишь 1.3 КБ.

Утечка переводов:

По умолчанию почти 90% текста, отправляемого на страницу, относится к другим маршрутам. Ручное разделение на неймспейсы сложно поддерживать без ошибок.

График ниже оценивает объём контента для теоретического приложения, в котором от 1 до 10 страниц и от 1 до 10 языков, примерно по 30 КБ текста на страницу. Динамическая загрузка по локали убирает ось языков, ограничение контента компонентом или маршрутом убирает ось страниц, и только их сочетание сохраняет объём стабильным.

Задержка гидратации:

Компоненты с react-i18next гидратировались 85 мс против 24 мс у Intlayer. Передача объемных структур JSON клиенту замедляет взаимодействие.

Почему i18next тяжелый?

Накопление функций в runtime

Работа исключительно в браузере требует загрузки всех механизмов сразу: интерполяции, правил множественного числа, контекстов, форматирования и шины событий. Даже базовый вывод строки оплачивает полный движок.

Динамические ключи исключают tree-shaking

Так как "hero.title" вычисляется динамически во время выполнения, бандлеры не могут определить, какие ключи задействованы. Неиспользуемые строки неизбежно остаются в бандле.

const { t } = useTranslation("home");

return <h1>{t("hero.title")}</h1>;

const { title } = useIntlayer("hero");

return <h1>{title}</h1>;

Компилятор Intlayer проверяет реальное использование полей в Hero.tsx и исключает лишние данные до создания клиентских бандлов. Подробнее в разделе оптимизация бандла.

Опыт разработки

Разрозненный JSON против ко-локации

В i18next переводы изолированы в отдельных директориях JSON вдалеке от компонентов. Intlayer размещает файлы контента рядом с компонентами:

{
  "title": "Ship in every language"
}

{
  "title": "Запускайте на любом языке"
}

import { useTranslation } from "react-i18next";

export const Hero = () => {
  const { t } = useTranslation("hero");
  return <h1>{t("title")}</h1>;
};

import { t, type Dictionary } from "intlayer";

export default {
  key: "hero",
  content: {
    title: t({
      en: "Ship in every language",
      ru: "Запускайте на любом языке",
    }),
  },
} satisfies Dictionary;

import { useIntlayer } from "react-intlayer";

export const Hero = () => {
  const { title } = useIntlayer("hero");
  return <h1>{title}</h1>;
};

При переносе или удалении Hero.tsx его переводы перемещаются или удаляются вместе с ним.

Автодополнение против строгой безопасности типов

Расширение CustomTypeOptions дает подсказки в IDE, но не проверяет наличие реального перевода. Удаление ключа из ru/home.json не остановит сборку, а лишь вызовет runtime-фоллбэк.

Intlayer создает типы на основе объявлений контента, а режим strictMode превращает отсутствующие переводы в строгие ошибки сборки.

Сравнение экосистемы

Модель переводов и подход Locize

Locize является коммерческим сервисом от создателей i18next. Устойчивость открытого кода важна, но такая модель создает конфликт целей: сервис, зарабатывающий на платной платформе переводов, не заинтересован во внедрении бесплатного локального ИИ-перевода прямо в CLI.

Intlayer предлагает открытое решение:

• intlayer fill дополняет недостающие переводы в консоли или CI с помощью ваших собственных ключей OpenAI, Anthropic, Mistral или Gemini.
• Intlayer CMS имеет открытый исходный код и запускается локально через Docker Compose.
• Компилятор, CLI, редактор и CMS распространяются под лицензией Apache 2.0.

Когда i18next по-прежнему актуален?

Как улучшить текущую конфигурацию i18next?

Intlayer предлагает готовые пакеты совместимости, полностью повторяющие сигнатуры функций библиотек i18next (i18next, react-i18next и next-i18next). Вам не нужно переписывать компоненты, чтобы получить преимущества современной архитектуры на базе компилятора.

Настройка выполняется одной командой:

npx intlayer init --interactive

Интерактивный интерфейс командной строки:

1. Устанавливает пакет совместимости @intlayer/i18next.
2. Настраивает алиасы сборщика, чтобы привычные импорты (useTranslation, Trans, t) прозрачно ссылались на Intlayer, позволяя удалить старую библиотеку из package.json.
3. Сразу подключает поддержку языкового сервера (LSP) в редакторе, оптимизацию бандла на этапе сборки (полный tree-shaking) и локальные инструменты перевода с помощью ИИ.

Подробные инструкции можно найти в наших руководствах:

• Слои совместимости: Сохраняйте существующий синтаксис с адаптерами для i18next, react-i18next и next-i18next.
• Миграция каталогов: Конвертируйте JSON-файлы в строго типизированные словари: с i18next, с react-i18next или с next-i18next.
• Гибридная архитектура: Оставьте движок i18next в работе, подключив Intlayer для типизации и автоматического перевода каталогов.

Проверьте ваш сайт на вес и утечки с помощью бесплатного SEO-сканера i18n:

Рекомендуемые материалы