Nextjs 中的路由国际化指南 (i)
积累知识,胜过积蓄金银!毕竟在文章开发的过程中,会遇到各种各样的问题,往往都是一些细节知识点还没有掌握好而导致的,因此基础知识点的积累是很重要的。下面本文《Nextjs 中的路由国际化指南 (i)》,就带大家讲解一下知识点,若是你对本文感兴趣,或者是想搞懂其中某个知识点,就请你继续往下看吧~

国际化(i18n)是设计应用程序的过程,使其能够轻松适应不同的语言和地区,而无需进行工程更改。在本文中,您将学习如何在 next.js 应用程序中设置 i18n 并使用 next-intl 创建语言切换器以在英语和西班牙语之间切换。
安装
首先,您需要安装 next-intl 库,它有助于管理 next.js 中的国际化。在终端中运行以下命令:
npm install next-intl
项目结构
项目结构如下:
├── messages
│ ├── en.json
│ └── es.json
├── next.config.mjs
└── src
├── i18n.ts
├── middleware.ts
└── app
└── [locale]
├── layout.tsx
└── page.tsx
1. 设置翻译消息
在项目的根目录下创建一个 messages 目录。在此目录中,为您想要支持的每种语言添加 json 文件。
消息/en.json
{
"greeting": "hello codú",
"farewell": "goodbye codú"
}
消息/es.json
{
"greeting": "hola codú",
"farewell": "adiós codú"
}
这些文件包含您的应用程序将使用的短语的翻译。
2. 配置next.js
在 next.config.mjs 中配置 next.js 以支持国际化。
下一个配置.mjs
import { getrequestconfig } from 'next-intl/server';
// list of supported languages
const locales = ['en', 'es'];
export default getrequestconfig(async ({ locale }) => {
// validate that the incoming `locale` parameter is valid
if (!locales.includes(locale)) {
return { notfound: true };
}
return {
messages: (await import(`./messages/${locale}.json`)).default
};
});
此文件配置 next.js 以根据请求的语言加载正确的翻译消息。
3. 国际化中间件
创建中间件来处理重定向和设置默认语言。
src/中间件.ts
import createmiddleware from 'next-intl/middleware';
export default createmiddleware({
// list of all supported languages
locales: ['en', 'es'],
// default language
defaultlocale: 'en'
});
export const config = {
// only match internationalised pathnames
matcher: ['/', '/(en|es)/:path*']
};
如果未指定,此中间件会处理重定向到默认语言。
4. 国际化配置
创建配置文件来管理国际化设置。
src/i18n.ts
import { notfound } from 'next/navigation';
import { getrequestconfig } from 'next-intl/server';
const locales = ['en', 'es'];
export default getrequestconfig(async ({ locale }) => {
if (!locales.includes(locale as any)) notfound();
return {
messages: (await import(`../messages/${locale}.json`)).default
};
});
此文件验证区域设置并加载相应的消息。
5. 设置布局和页面
配置布局和主页以支持国际化。
src/app/[语言环境]/layout.tsx
import { uselocale } from 'next-intl';
import { reactnode } from 'react';
export default function layout({ children }: { children: reactnode }) {
const locale = uselocale();
return (
{children}
);
}
src/app/[语言环境]/page.tsx
import { usetranslations } from 'next-intl';
export default function page() {
const t = usetranslations();
return (
{t('greeting')}
{t('farewell')}
);
}
这些文件配置布局和主页以使用翻译。
6. 创建语言切换器
最后,创建一个语言切换器以在英语和西班牙语之间切换。
src/app/[语言环境]/switcher.tsx
'use client';
import { useLocale } from 'next-intl';
import { useRouter } from 'next/navigation';
import { ChangeEvent, useTransition } from 'react';
export default function LocalSwitcher() {
const [isPending, startTransition] = useTransition();
const router = useRouter();
const localActive = useLocale();
const onSelectChange = (e: ChangeEvent) => {
const nextLocale = e.target.value;
startTransition(() => {
router.replace(`/${nextLocale}`);
});
};
return (
);
}
该组件允许用户更改界面语言。
结论
通过这些步骤,您已成功在 next.js 应用程序中设置国际化,并创建了一个语言切换器以在英语和西班牙语之间切换。这将使您的应用程序支持多种语言并提供本地化的用户体验。
文中关于的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《Nextjs 中的路由国际化指南 (i)》文章吧,也可关注golang学习网公众号了解相关技术文章。
Java 中的 Spring Boot 简介
- 上一篇
- Java 中的 Spring Boot 简介
- 下一篇
- JavaScript 函数式编程简介:不同的 monad #11
-
- 文章 · 前端 | 1小时前 | 环境变量 vite loadEnv vite.config
- Vite 环境变量为什么在配置加载时取不到
- 133浏览 收藏
-
- 文章 · 前端 | 2小时前 |
- React useOptimistic 怎么在请求失败时回滚列表
- 153浏览 收藏
-
- 文章 · 前端 | 4小时前 | 前端开发 · 前端路由 hostname URLPattern pathname
- URLPattern 怎么同时匹配域名和路径参数
- 108浏览 收藏
-
- 文章 · 前端 | 6小时前 | javascript · JavaScript Intl.DurationFormat 前端国际化 持续时间格式化
- Intl.DurationFormat 怎么本地化显示持续时间
- 141浏览 收藏
-
- 文章 · 前端 | 8小时前 | 前端开发 · 浏览器API · postMessage MessageChannel Web Worker MessagePort
- postMessage 转移 MessagePort 后原端口还能用吗
- 477浏览 收藏
-
- 文章 · 前端 | 10小时前 | html · 前端 · LCP fetchpriority HTMLImageElement.fetchPriority 首屏图片 图片加载优先级
- fetchpriority 怎么只提升首屏关键图片
- 343浏览 收藏
-
- 文章 · 前端 | 13小时前 |
- AbortSignal.any 怎么合并超时和用户取消
- 106浏览 收藏
-
- 文章 · 前端 | 17小时前 | 前端 · 性能优化 · javascript · scheduler.postTask TaskController Prioritized Task Scheduling API TaskSignal JavaScript任务优先级
- Scheduler.postTask 怎么设置任务优先级
- 148浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · View Transition API startViewTransition ViewTransitionTypeSet pageswap pagereveal
- View Transition types 怎么为不同导航选择动画
- 195浏览 收藏
-
- 文章 · 前端 | 1天前 | dialog close HTMLDialogElement requestClose
- HTMLDialogElement requestClose 和 close 有什么区别
- 363浏览 收藏
-
- 文章 · 前端 | 1天前 | html · 前端开发 · Popover API popover auto 点击外部关闭 Light Dismiss
- Popover API 怎么实现点击外部自动关闭
- 225浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · css · CSS 容器查询 cqi cqb inline-size block-size
- CSS cqi 和 cqb 单位分别跟随哪个容器轴
- 470浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 356次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 416次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 424次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 380次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 204次使用
-
- JavaScript函数定义及示例详解
- 2025-05-11 502浏览
-
- 智能体安全引领产业升级——国内AI安全产品市场深度分析
- 2026-08-21 501浏览
-
- CSS变量简化按钮悬停效果技巧
- 2026-05-31 501浏览
-
- JavaScript符号类型详解与应用
- 2026-05-31 501浏览
-
- HTML剪贴板复制粘贴怎么用
- 2026-05-26 501浏览

