Интернационализация в 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 — готовое решение