For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt, and this page is available as Markdown at /zh/guides/advanced-features/international.md.
  • 简体中文

      • 国际化

      @modern-js/plugin-i18n 是 Modern.js 的国际化插件，基于 i18next 和 react-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 支持：完整类型定义，支持翻译键类型安全检查