Repolode
amannn

amannn/next-intl

面向 Next.js 的国际化(i18n)库,支持 ICU 消息语法、本地化日期数字格式和类型安全的翻译 Hook。

Star
4,393
Fork
396
未关闭 Issue
56
最近提交
23小时前

这是什么?

next-intl 为 Next.js 应用提供国际化能力。开发者可以在 JSON 文件中使用 ICU 消息语法编写译文,支持变量插值、复数、基于枚举的文案选择以及富文本。

库提供统一的 Hook 风格 API,用于将翻译转为纯文本或富文本。日期、时间和数字的格式化在服务端与客户端组件之间保持一致,并处理了时区差异。消息 key 支持类型检查和自动补全,拼写错误或缺失的 key 可在编译期发现。

它兼容 Next.js App Router 与 Server Components,支持静态渲染。国际化路由功能可为每种语言提供独立路径,并可选择本地化路径名以优化 SEO。配套命令行工具 eloqnt 可检查消息一致性,也可自动补全缺失的翻译。

核心功能

  • 01支持 ICU 消息语法,包括变量插值、复数、枚举选择和富文本
  • 02日期、时间和数字格式化在服务端与客户端保持一致
  • 03消息 key 类型安全,并支持自动补全
  • 04统一的 Hook 风格 API,可在整个代码库中使用
  • 05兼容 App Router、Server Components 与静态渲染
  • 06国际化路由,支持按语言区分路径并可本地化路径名

适用场景

  • 为基于 Next.js App Router 的网站增加多语言支持
  • 在不同语言环境中正确格式化日期并处理复数文案
  • 为多语言网站提供本地化 URL 以优化 SEO

使用前须知

  • 专为 Next.js 设计,不是通用的国际化库。

标签

常见问题

next-intl 是什么?
面向 Next.js 的国际化(i18n)库,支持 ICU 消息语法、本地化日期数字格式和类型安全的翻译 Hook。 next-intl 为 Next.js 应用提供国际化能力。开发者可以在 JSON 文件中使用 ICU 消息语法编写译文,支持变量插值、复数、基于枚举的文案选择以及富文本。
next-intl 可以免费使用吗?用的什么许可证?
next-intl 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
next-intl 还在维护吗?
活跃维护中。next-intl 最近一次提交是在 2026年11月6日。
next-intl 适合用来做什么?
为基于 Next.js App Router 的网站增加多语言支持 在不同语言环境中正确格式化日期并处理复数文案 为多语言网站提供本地化 URL 以优化 SEO
在哪里获取 next-intl?
源代码和安装说明在 GitHub 上:https://github.com/amannn/next-intl

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目