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

    Миграция с next-i18next на Intlayer

    Для полного и подробного пошагового учебника см. наше полное руководство по миграции next-i18next.

    Intlayer прозрачно обрабатывает все реализации Next.js Pages Router и App Router. Использование адаптера позволяет вам перенести вашу реализацию next-i18next без переписывания кода.

    Что делать

    Чтобы начать, запустите:

    bash
    npx intlayer init

    Это создает требуемый файл настройки Intlayer. Чтобы переключиться на Intlayer за кулисами, обновите ваш next.config.ts:

    next.config.ts
    import type { NextConfig } from "next";import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";const withIntlayer = createNextI18nPlugin();const nextConfig: NextConfig = {};export default withIntlayer(nextConfig);

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

    createNextI18nPlugin компонует встроенное поведение Next.js вместе с основным плагином next-intlayer, вводя все необходимые псевдонимы Webpack/Turbopack для next-i18next, react-i18next и i18next.

    Под капотом:

    • serverSideTranslations & appWithTranslation: Теперь они функционируют как обертки для внутренних загрузчиков Intlayer, обходя большие статические впрыскивания JSON.
    • Клиентские хуки: Немедленно делегирует на @intlayer/react-i18next, сохраняя все возможности форматирования, множественного числа и вложенных пространств имён.