re:re:actable
Урок 065 минут чтения

Интернационализация в App Router

На этой странице
Кратко

В App Router мультиязычность строят на сегменте маршрута app/[locale]/…: язык — часть URL (/ru/books, /en/books), поэтому каждая версия индексируется отдельно и ей можно поделиться ссылкой. Нужны: список поддерживаемых локалей и проверка параметра (неизвестный язык → notFound()), generateStaticParams для пререндера всех языков, lang у <html> из параметра, словари (загружаются на сервере и не попадают в клиентский бандл целиком), определение языка в proxy.ts по cookie и Accept-Language с редиректом только с «голого» /, hreflang через alternates.languages, форматирование дат, чисел и валют через Intl. С Next 16.3 язык корневого сегмента можно читать в любом серверном компоненте через root params (import { locale } from 'next/root-params'). Готовое решение — next-intl (маршрутизация, словари, ICU-плюрализация, типизация ключей).

Вопрос

Как сделать мультиязычное приложение на Next.js App Router? Где хранить язык, как загружать переводы и не сломать SEO?

Структура

app/
└── [locale]/
    ├── layout.tsx        ← <html lang={locale}>, проверка locale
    ├── page.tsx
    └── books/[slug]/page.tsx
dictionaries/
├── ru.json
└── en.json
proxy.ts                  ← редирект "/" → "/ru" по cookie / Accept-Language

Локали и словари

// i18n/config.ts
export const locales = ['ru', 'en'] as const;
export type Locale = (typeof locales)[number];
export const defaultLocale: Locale = 'ru';
export const isLocale = (v: string): v is Locale => (locales as readonly string[]).includes(v);
// i18n/dictionaries.ts
import 'server-only';
import type { Locale } from './config';
 
const dictionaries = {
  ru: () => import('@/dictionaries/ru.json').then((m) => m.default),
  en: () => import('@/dictionaries/en.json').then((m) => m.default),
};
 
export const getDictionary = (locale: Locale) => dictionaries[locale]();

Layout с языком

// app/[locale]/layout.tsx
import { notFound } from 'next/navigation';
import { locales, isLocale } from '@/i18n/config';
 
export function generateStaticParams() {
  return locales.map((locale) => ({ locale })); // пререндер всех языков
}
 
export default async function LocaleLayout({ children, params }: LayoutProps<'/[locale]'>) {
  const { locale } = await params;
  if (!isLocale(locale)) notFound();
 
  return (
    <html lang={locale}>
      <body>{children}</body>
    </html>
  );
}

Страница с переводами и форматированием

// app/[locale]/books/[slug]/page.tsx
import { getDictionary } from '@/i18n/dictionaries';
 
export default async function BookPage({ params }: PageProps<'/[locale]/books/[slug]'>) {
  const { locale, slug } = await params;
  const t = await getDictionary(locale as Locale);
  const book = await getBook(slug, locale);
 
  const price = new Intl.NumberFormat(locale, { style: 'currency', currency: locale === 'ru' ? 'RUB' : 'USD' })
    .format(book.price);
  const published = new Intl.DateTimeFormat(locale, { dateStyle: 'long' }).format(book.publishedAt);
 
  return (
    <article>
      <h1>{book.title}</h1>
      <p>{t.book.price}: {price}</p>
      <p>{t.book.published}: {published}</p>
      <AddToCart label={t.book.addToCart} /> {/* в клиент передаём только нужные строки */}
    </article>
  );
}

Словарь целиком остаётся на сервере; клиентским компонентам передают только их строки — меньше JS.

Root params (Next 16.3+)

import { locale } from 'next/root-params';
 
export async function Footer() {
  const current = await locale(); // без прокидывания props через всё дерево
  const t = await getDictionary(current as Locale);
  return <footer>{t.footer.copyright}</footer>;
}

Определение языка в proxy.ts

// proxy.ts
import { NextResponse, type NextRequest } from 'next/server';
import { locales, defaultLocale } from '@/i18n/config';
 
export function proxy(request: NextRequest) {
  const { pathname } = request.nextUrl;
  const hasLocale = locales.some((l) => pathname === `/${l}` || pathname.startsWith(`/${l}/`));
  if (hasLocale) return NextResponse.next();
 
  const fromCookie = request.cookies.get('NEXT_LOCALE')?.value;
  const fromHeader = request.headers.get('accept-language')?.split(',')[0]?.slice(0, 2);
  const locale = [fromCookie, fromHeader].find((l) => l && (locales as readonly string[]).includes(l)) ?? defaultLocale;
 
  return NextResponse.redirect(new URL(`/${locale}${pathname}`, request.url));
}
 
export const config = { matcher: ['/((?!_next|api|.*\\..*).*)'] };
Внимание

Редиректить по языку можно только адреса без локали. Если пользователь (или поисковый робот) открыл /en/books, нельзя перебрасывать его на /ru/books по IP или заголовку — иначе английская версия станет недоступной для индексации. Предложи переключение баннером и запомни выбор в cookie.

SEO: hreflang

export async function generateMetadata({ params }: PageProps<'/[locale]/books/[slug]'>): Promise<Metadata> {
  const { locale, slug } = await params;
  return {
    alternates: {
      canonical: `/${locale}/books/${slug}`,
      languages: {
        ru: `/ru/books/${slug}`,
        en: `/en/books/${slug}`,
        'x-default': `/en/books/${slug}`,
      },
    },
  };
}

Переключатель языка

'use client';
import Link from 'next/link';
import { usePathname } from 'next/navigation';
 
export function LocaleSwitcher({ current }: { current: Locale }) {
  const pathname = usePathname();
  const rest = pathname.replace(/^\/(ru|en)/, '');
  return (
    <nav aria-label="Язык">
      <Link href={`/ru${rest}`} hrefLang="ru" aria-current={current === 'ru' ? 'true' : undefined}>Русский</Link>
      <Link href={`/en${rest}`} hrefLang="en" aria-current={current === 'en' ? 'true' : undefined}>English</Link>
    </nav>
  );
}

Ссылки, а не select с router.push, — их видят роботы и пользователи клавиатуры.

next-intl

Библиотека берёт на себя то, что выше написано вручную: middleware/proxy-маршрутизацию, getTranslations в серверных и useTranslations в клиентских компонентах, ICU-сообщения ({count, plural, one {# книга} few {# книги} many {# книг}}), форматирование, типизацию ключей словаря и локализованные пути (/ru/knigi ↔ /en/books).

Частые ошибки

  • Язык в cookie без отражения в URL — поисковик видит только одну версию.
  • Весь словарь на всех языках в клиентском бандле.
  • lang="ru" захардкожен в корневом layout для всех версий.
  • Склейка строк вместо плюрализации: «1 книг», «2 книга».
  • Перевод только интерфейса, а контент (цены, даты, примеры) не локализован.

Мини-шпаргалка

app/[locale]/... + generateStaticParams по locales
Проверка locale → notFound()
<html lang={locale}>
Словари на сервере (server-only), клиенту — только нужные строки
proxy.ts: редирект только с путей без локали, cookie NEXT_LOCALE
Intl.NumberFormat / DateTimeFormat / PluralRules
alternates.languages + x-default
16.3+: next/root-params
next-intl — готовое решение

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам