国际化

@modern-js/plugin-i18n 是 Modern.js 的国际化插件,基于 i18nextreact-i18next 构建。

  • 插件本身:负责与 Modern.js 框架的集成,如 SSR 语言传递、路由前缀处理等
  • i18next:核心翻译能力,如 t() 函数、插值、复数、命名空间。
  • react-i18next:React 组件和 Hook,如 useTranslation,实现与 React 生命周期的结合。

从哪里开始?

想做的事文档
首次接入,跑通示例快速开始
了解完整的配置选项配置说明
根据 URL / Cookie / Header 自动判断语言语言检测
实现 /en/about 这类带语言前缀的路径路由集成
从远程服务或平台加载翻译资源资源加载 → 自定义后端
SSR 场景、多入口、自定义实例高级用法
查询 Hook / 组件 / 类型定义API 参考

核心能力

  • 语言检测:支持 URL 路径、Cookie、LocalStorage、请求头、浏览器设置等多种检测方式,可自由组合优先级
  • 资源加载:支持 HTTP 静态文件、文件系统(SSR)、SDK 自定义函数三种后端,以及链式后端渐进加载
  • 路由集成:自动添加语言路径前缀(/en/about),提供 I18nLink 组件处理语言感知导航
  • SSR 支持:服务端检测语言并注入到页面,客户端直接使用,避免语言闪烁
  • TypeScript 支持:完整类型定义,支持翻译键类型安全检查