i18next/next-i18next

Что это?

Ключевые возможности

• 01Поддерживает App Router, Pages Router и проекты со смешанными роутерами в одной кодовой базе.
• 02Определяет язык по cookie или Accept-Language и перенаправляет на пути с префиксом локали.
• 03Загружает переводы из файлов в public или с помощью динамических импортов, совместимых с бессерверными платформами.
• 04Передаёт сериализованные загруженные ресурсы из серверных компонентов в клиентские.
• 05Поддерживает форматы сообщений ICU и MF2 через дополнительные плагины.
• 06Позволяет подключать собственные бэкенды i18next, например HTTP и Locize.

Сценарии использования

• Добавление поддержки нескольких языков в существующий сайт на Next.js с App Router.
• Совместная работа локализованных и нелокализованных маршрутов при переходе с Pages Router.
• Развёртывание переведённого Next.js-приложения на Vercel или других бессерверных платформах.
• Загрузка переводов из CDN или сервиса управления переводами.

Быстрый старт

1. 1

   Установите пакеты

   npm install next-i18next i18next react-i18next
2. 2

   Создайте JSON-файлы переводов и конфигурацию i18n с resourceLoader

3. 3

   Добавьте proxy.ts, экспортирующий createProxy(i18nConfig)

4. 4

   Настройте корневой layout с помощью initServerI18next и I18nProvider

Что важно знать

• !На бессерверных платформах переводы необходимо загружать с помощью resourceLoader, поскольку файлы из public/ недоступны во время выполнения.
• !При разработке горячая перезагрузка переводов с загрузчиками на основе import() может зависать — потребуется обходное решение.
• !При включённом cacheComponents команда next dev предупреждает о данных без кэша при чтении переводов из файлов.

Темы

Частые вопросы

Что такое next-i18next?

Инструментарий для переводов Next.js-приложений: интегрирует i18next и react-i18next с App Router, Pages Router и middleware. next-i18next дополняет i18next и react-i18next, обрабатывая специфичные для Next.js задачи перевода приложения: определение языка через proxy/middleware и перенаправление на нужную локаль, разделение серверных и клиентских компонентов, а также передачу загруженных переводов с сервера на клиент.

next-i18next можно использовать бесплатно? Какая у него лицензия?

next-i18next распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

next-i18next всё ещё поддерживается?

Активно поддерживается. Последний коммит в next-i18next — 3 нояб. 2026 г..

Для чего можно использовать next-i18next?

Добавление поддержки нескольких языков в существующий сайт на Next.js с App Router. Совместная работа локализованных и нелокализованных маршрутов при переходе с Pages Router. Развёртывание переведённого Next.js-приложения на Vercel или других бессерверных платформах. Загрузка переводов из CDN или сервиса управления переводами.

Как установить next-i18next?

Установите пакеты: npm install next-i18next i18next react-i18next Создайте JSON-файлы переводов и конфигурацию i18n с resourceLoader Добавьте proxy.ts, экспортирующий createProxy(i18nConfig) Настройте корневой layout с помощью initServerI18next и I18nProvider

Где скачать next-i18next?

Исходный код и инструкции по установке — на GitHub: https://github.com/i18next/next-i18next