
Потпун водич за Next.js интернационализацију
Подесите next-intl са App Router, конфигуришите усмеравање локала и аутоматизујте преводе помоћу AI.
Инсталирајте next-intl
next-intl је један пакет који обрађује усмеравање локала, учитавање порука и hook функције превода за Next.js App Router.
npm install next-intlНаправите i18n конфигурацију захтева
Направите две датотеке: src/i18n/request.ts за учитавање порука и src/i18n/routing.ts за дефиниције локала. Оне одређују како next-intl разрешава поруке и руте.
// src/i18n/routing.ts
import { defineRouting } from 'next-intl/routing';
import { createNavigation } from 'next-intl/navigation';
export const routing = defineRouting({
locales: ['en', 'de', 'ja', 'es'],
defaultLocale: 'en',
localePrefix: 'as-needed', // /about for en, /de/about for de
});
export const { Link, redirect, usePathname, useRouter } =
createNavigation(routing);Конфигуришите middleware
Додајте middleware.ts за откривање локала, преписивање URL адреса и преусмеравања. Middleware пресреће сваки захтев и обезбеђује примену исправног локала.
// middleware.ts <- Must be in project ROOT, not src/
import createMiddleware from 'next-intl/middleware';
import { routing } from './src/i18n/routing';
export default createMiddleware(routing);
export const config = {
matcher: ['/((?!api|_next|.*\\..*).*)'],
};Подесите структуру фасцикле [locale]
Преместите руте апликације у app/[locale]/. Додајте generateStaticParams да при компоновању направите странице за сваки локал. Тако настају URL адресе /en/about, /de/about и друге.
// app/[locale]/layout.tsx
import { routing } from '@/i18n/routing';
export function generateStaticParams() {
return routing.locales.map((locale) => ({ locale }));
}Ажурирајте коренски распоред
Учитајте поруке помоћу getMessages() и проследите их у NextIntlClientProvider у коренском распореду локала. Поставите html атрибут lang из параметра локала.
// app/[locale]/layout.tsx
import { NextIntlClientProvider } from 'next-intl';
import { getMessages, setRequestLocale } from 'next-intl/server';
import { routing } from '@/i18n/routing';
import { notFound } from 'next/navigation';
export function generateStaticParams() {
return routing.locales.map((locale) => ({ locale }));
}
export default async function LocaleLayout({
children,
params,
}: {
children: React.ReactNode;
params: { locale: string };
}) {
const { locale } = await params;
if (!routing.locales.includes(locale as any)) notFound();
setRequestLocale(locale);
const messages = await getMessages();
return (
<html lang={locale}>
<body>
<NextIntlClientProvider locale={locale} messages={messages}>
{children}
</NextIntlClientProvider>
</body>
</html>
);
}Користите преводе у компонентама
Серверске компоненте користе getTranslations (async, await), а клијентске useTranslations (hook). Изаберите према месту приказивања компоненте — серверске компоненте потпуно изостављају преводе из JavaScript пакета.
// Server Component (default)
import { getTranslations, setRequestLocale } from 'next-intl/server';
export default async function AboutPage({
params,
}: { params: { locale: string } }) {
const { locale } = await params;
setRequestLocale(locale);
const t = await getTranslations('AboutPage');
return <h1>{t('title')}</h1>;
}
// Client Component ('use client')
'use client';
import { useTranslations } from 'next-intl';
export default function SearchBar() {
const t = useTranslations('SearchBar');
return <input placeholder={t('placeholder')} />;
}Додајте SEO: метаподатке и hreflang
Користите generateMetadata да направите наслове и описе страница за сваки локал. Додајте alternates.languages за hreflang ознаке како би претраживачи открили све језичке верзије сваке странице.
// app/[locale]/layout.tsx or any page.tsx
import { getTranslations } from 'next-intl/server';
import { routing } from '@/i18n/routing';
export async function generateMetadata({
params,
}: { params: { locale: string } }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: 'Metadata' });
return {
title: t('title'),
description: t('description'),
alternates: {
languages: Object.fromEntries(
routing.locales.map((l) => [l, `/${l}`])
),
},
};
}Обрадите странице грешке и непостојеће странице
error.tsx и not-found.tsx захтевају посебну обраду јер могу да се прикажу ван уобичајеног распореда локала. Корени not-found.tsx захтева сопствено i18n подешавање добављача да прикаже локализоване поруке о грешкама.
// app/[locale]/error.tsx
'use client';
import { useTranslations } from 'next-intl';
export default function Error() {
const t = useTranslations('Error');
return (
<div>
<h1>{t('title')}</h1>
<p>{t('description')}</p>
</div>
);
}
// app/not-found.tsx (root level -- needs own provider)
import { routing } from '@/i18n/routing';
export default async function GlobalNotFound() {
return (
<html lang={routing.defaultLocale}>
<body>
<h1>404 - Page Not Found</h1>
</body>
</html>
);
}Аутоматизујте преводе
Када завршите i18n подешавање, преведите датотеке порука помоћу AI директно из IDE окружења или користите i18n Agent CLI у CI/CD pipeline процесу за аутоматски превод при сваком постављању.
# In your IDE, ask your AI assistant:
> Translate messages/en.json to German, Japanese, and Spanish
✓ messages/de.json created (1.1s)
✓ messages/ja.json created (1.4s)
✓ messages/es.json created (1.0s)Аутоматизујте квалитет превода
Алати отвореног кода за Next.js i18n
Ови пакети отвореног кода решавају уобичајене проблеме у токовима Next.js интернационализације.
next-intl-localechain
Стандардни next-intl одмах прелази на подразумевани локал када превод недостаје. Корисник бразилског португалског види енглески уместо потпуно добрих pt-PT превода. next-intl-localechain додаје паметне резервне ланце — дубоко спаја преводе сродних локала како би регионални корисници увек видели најближи доступан превод.
import { getRequestConfig } from 'next-intl/server';
import { withLocaleChain } from 'next-intl-localechain';
export default getRequestConfig(withLocaleChain({
loadMessages: (locale) =>
import(`../../messages/${locale}.json`).then(m => m.default),
defaultLocale: 'en'
}));@i18n-agent/cli
Алат командне линије за превођење Next.js датотека порука без напуштања терминала. Директно преводите датотеке, проверавајте стање задатка и преузимајте резултате. Ради у CI/CD pipeline процесима са потврдом идентитета API кључем ради потпуно аутоматизоване локализације.
# Install the CLI
npm install -g @i18n-agent/cli
# Authenticate
i18nagent login
# Translate your message files
i18nagent translate ./messages/en.json --lang de,ja,es
# Or use in CI/CD with an API key
export I18N_AGENT_API_KEY=your-key-here
i18nagent translate ./messages/en.json --lang de,ja,esУобичајене замке
„Unable to find next-intl locale"
Middleware није обухватио захтев. Проверите: да ли је middleware.ts у корену пројекта, да ли matcher правилно искључује статичке датотеке и да ли је локал укључен у конфигурацију усмеравања.
Неочекивано динамичко приказивање
setRequestLocale(locale) недостаје на страници или у распореду. Без њега next-intl користи заглавља и колачиће за откривање локала, што намеће динамичко приказивање и спречава статичко генерисање.
Паралелне руте не раде са i18n
Паралелне руте (@modal) и руте пресретања ((.)photo) имају познате некомпатибилности са динамичким сегментом [locale]. За ове напредне обрасце користите усмеравање преко middleware слоја као заобилазно решење.
Промена језика губи тренутну руту
При промени локала сачувајте тренутну путању помоћу usePathname() и замените само сегмент локала. Пазите на параметре динамичке руте — морају поново да се разреше за нови локал.
Препоручена структура датотека
my-nextjs-app/
├── middleware.ts # Locale routing (project root!)
├── next.config.mjs
├── messages/
│ ├── en.json # Source messages
│ ├── de.json
│ └── ja.json
├── src/
│ ├── i18n/
│ │ ├── request.ts # Message loading config
│ │ └── routing.ts # Locale definitions
│ └── app/
│ └── [locale]/
│ ├── layout.tsx # Root locale layout
│ ├── page.tsx # Home page
│ ├── error.tsx # Localized error page
│ ├── not-found.tsx # Localized 404
│ └── about/
│ └── page.tsx
└── package.jsonИспробајте i18n Agent сада
Пустите датотеку за превођење овде
JSON, YAML, PO, XML, CSV, Markdown, Properties
или кликните за избор
Циљни језици
Резервни локали са next-intl-localechain
Када у регионалном локалу као што је pt-BR недостаје кључ превода, next-intl одмах прелази на подразумевани локал уместо да најпре провери надређени локал pt.
npm install next-intl-localechainimport { withLocaleChain } from 'next-intl-localechain';
export default withLocaleChain({
fallbacks: {
'pt-BR': ['pt', 'en'],
'zh-Hant-HK': ['zh-Hant', 'zh', 'en'],
},
defaultLocale: 'en',
loadMessages: (locale) => import(`./messages/${locale}.json`),
});Погледајте наш водич за резервне локале за целу листу подржаних система и 75 уграђених ланаца. Learn more →