
Fullnaðarleiðarvísir um alþjóðavæðingu Next.js
Settu next-intl upp með App Router, grunnstilltu tungumálaleiðaval og gerðu þýðingar sjálfvirkar með gervigreind.
Settu next-intl upp
next-intl er einn pakki sem sér um tungumálaleiðaval, hleðslu skilaboða og þýðingarkróka fyrir Next.js App Router.
npm install next-intlBúðu til i18n-beiðnastillinguna
Búðu til tvær skrár: src/i18n/request.ts fyrir hleðslu skilaboða og src/i18n/routing.ts fyrir skilgreiningar tungumálasniða. Þær ákvarða hvernig next-intl finnur skilaboð og leiðir.
// 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);Grunnstilltu millibúnað
Bættu middleware.ts við til að annast greiningu tungumálasniðs, endurritun vefslóða og áframsendingar. Millibúnaðurinn grípur hverja beiðni og tryggir að réttu tungumálasniði sé beitt.
// 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|.*\\..*).*)'],
};Settu upp [locale]-möppuskipanina
Færðu forritsleiðirnar inn í app/[locale]/. Bættu generateStaticParams við til að búa til síður fyrir hvert tungumálasnið við smíði. Þannig verður vefslóðaskipanin /en/about, /de/about o.s.frv.
// app/[locale]/layout.tsx
import { routing } from '@/i18n/routing';
export function generateStaticParams() {
return routing.locales.map((locale) => ({ locale }));
}Uppfærðu rótarsíðuskipulagið
Hladdu skilaboðum með getMessages() og sendu þau til NextIntlClientProvider í rótarsíðuskipulagi tungumálasniðsins. Stilltu lang-eigindi html út frá færibreytu tungumálasniðsins.
// 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>
);
}Notaðu þýðingar í hlutum
Miðlarahlutar nota getTranslations (ósamstillt, await). Biðlarahlutar nota useTranslations (krók). Veldu eftir því hvar hluturinn er myndgerður — miðlarahlutar halda þýðingum alfarið utan JavaScript-pakkans.
// 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')} />;
}Bættu við leitarvélabestun: lýsigögnum og hreflang
Notaðu generateMetadata til að búa til tungumálasértæka síðutitla og lýsingar. Bættu alternates.languages við fyrir hreflang-merki svo leitarvélar finni allar tungumálaútgáfur hverrar síðu.
// 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}`])
),
},
};
}Meðhöndlaðu villu- og síður-finnast-ekki-síður
error.tsx og not-found.tsx þarfnast sérstakrar meðhöndlunar því þær geta verið myndgerðar utan venjulega tungumálasíðuskipulagsins. not-found.tsx í rótinni þarf eigin uppsetningu i18n-veitu til að birta staðfærð villuboð.
// 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>
);
}Gerðu þýðingar sjálfvirkar
Þegar i18n-uppsetningunni er lokið geturðu þýtt skilaboðaskrárnar með gervigreind beint úr þróunarumhverfinu eða notað skipanalínuviðmót i18n Agent í CI/CD-vinnslurásinni til að þýða sjálfvirkt við hverja útgáfu.
# 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)Gerðu þýðingargæði sjálfvirk
Opinn hugbúnaður fyrir i18n í Next.js
Þessir opnu hugbúnaðarpakkar leysa algenga erfiðleika í verkferlum við alþjóðavæðingu Next.js.
next-intl-localechain
Venjulegt next-intl fellur beint aftur á sjálfgefna tungumálasniðið þegar þýðingu vantar. Notandi brasilískrar portúgölsku sér ensku í stað fullgóðra pt-PT-þýðinga. next-intl-localechain bætir við snjöllum varatungumálakeðjum — það djúpsameinar þýðingar úr skyldum tungumálasniðum svo notendur svæðisbundinna sniða sjái ávallt nærtækustu tiltæku þýðinguna.
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
Skipanalínutól til að þýða Next.js-skilaboðaskrárnar þínar án þess að yfirgefa stjórnskjáinn. Þýddu skrár beint, athugaðu stöðu verka og sæktu niðurstöður. Virkar í CI/CD-vinnslurásum með auðkenningu með API-lykli fyrir alsjálfvirka staðfæringarverkferla.
# 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,esAlgengar gryfjur
"Unable to find next-intl locale"
Millibúnaðurinn samsvaraði ekki beiðninni. Athugaðu: er middleware.ts í rót verkefnisins? Útilokar samsvörunarmynstrið óbreytanlegar skrár rétt? Er tungumálasniðið tilgreint í leiðavalsstillingunni?
Óvænt kvik myndgerð
setRequestLocale(locale) vantar á síðu eða í síðuskipulag. Án þess notar next-intl hausa/vafrakökur til að greina tungumálasniðið, sem þvingar fram kvika myndgerð og kemur í veg fyrir fasta myndun.
Samhliða leiðir bila með i18n
Samhliða leiðir (@modal) og leiðir sem grípa inn í ((.)photo) eru þekktar fyrir ósamhæfi við kvika [locale]-leiðarhlutann. Notaðu leiðaval byggt á millibúnaði sem hjáleið fyrir þessi þróuðu leiðavalsmynstur.
Við tungumálaskipti glatast núverandi leið
Þegar skipt er um tungumálasnið skaltu varðveita núverandi slóðarheiti með usePathname() og aðeins skipta út tungumálahlutanum. Gættu þín á kvikum leiðarfæribreytum — leysa þarf þær aftur fyrir nýja tungumálasniðið.
Ráðlögð skráaskipan
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.jsonPrófaðu i18n Agent núna
Slepptu þýðingarskránni þinni hér
JSON, YAML, PO, XML, CSV, Markdown, Properties
eða smelltu til að fletta
Markmál
Varatungumálaval með next-intl-localechain
Þegar þýðingarlykil vantar í svæðisbundið tungumálasnið á borð við pt-BR stekkur next-intl beint í sjálfgefna tungumálasniðið í stað þess að athuga fyrst yfirtungumálasniðið 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`),
});Sjá leiðarvísi okkar um varatungumálaval fyrir heildarlista yfir studda hugbúnaðarramma og 75 innbyggðar keðjur. Learn more →