定义
i18next是一个面向JavaScript的国际化框架，属于软件库，可以集成进任意应用代码中使用。[1][4] 它把界面文本从源代码中抽离出来，按语言存放为资源文件，再通过统一的翻译函数在运行时取用，使同一套程序能够以多种语言呈现。[2] 与只提供基本字符串替换的库不同，它同时承担语言检测、翻译资源加载与缓存等由开发者自行处理的环节。[1]
原理
i18next以键值对形式组织翻译资源，键是程序中的标识符，值是目标语言文本，两者按语言和命名空间分层存放。调用方式为传入键并取得对应译文：i18next.t('key')。[5] 因为键名本身不会被当作兜底内容，所以键一般写成结构化标识而非自然语句，命名空间与嵌套层级分别用冒号和点号分隔。[5][6]
翻译请求会经过一整套解析流程：先拆分命名空间与键，再按当前语言、回退语言、复数形式和上下文变体逐级查找。查找键按优先级组合后缀，例如键加复数后缀、键加上下文后缀，或在计数为0时优先匹配专用的零值条目。[6] 当某一层找不到内容时，会依序尝试回退语言与回退命名空间，仍无结果则返回原键。[6]
插值用于把动态值嵌入译文，默认用双花括号包裹变量名，例如 {{count}}item，并支持附加格式化标记以调用自定义格式化函数。[7] 复数处理依照Unicode CLDR定义的语言复数类别进行：不同语言所需的类别数量并不相同，日语、汉语、韩语只用一类，英语、德语、西班牙语用两类，波兰语、俄语、乌克兰语用四类，阿拉伯语最多用到六类。i18next在v4格式中直接基于浏览器的Intl.PluralRules接口选择类别，并按$\text{键\_类别}$的形式取用对应译文。[8][7]
上下文机制沿用同一套后缀思路，为同一键提供按性别、正式程度等条件区分的版本，例如朋友一词可分别提供男性与女性说法；上下文还能与复数叠加使用，先取上下文再取复数形式。[6] 嵌套功能允许一个译文引用另一个键的内容，写作$t(key)形式，因此术语表这类需要复用同一表述的内容可以集中维护。连接后端加载译文、缓存、用户语言检测、复数和插值等功能均以可插拔模块的方式组合。[2]
发展历程
i18next的开发始于2011年。当时其创建者希望找到一个能同时运行在服务端Node.js和客户端单页应用上的国际化库，未能如愿，于是自行实现。[3] 项目由开源作者Jan Mühlemann与Adriano Raiano发起，早期版本还包含jQuery插件形式的用法。[4][9] 2011年末已有第三方技术博客介绍这一库用于本地化JavaScript应用。[10]
2.0版本于2015年发布，对代码进行了彻底重写，重点转向可扩展性设计，使框架能够适配不同的JavaScript环境、界面框架与翻译文件格式。[3][11] 在2.0发布后不久，社区又推出了react-i18next，为React组件提供钩子与组件形式的接口。[3]
复数处理在后续版本中经历一次格式调整：v21.0.0引入的JSON v4格式改变了复数后缀的写法，改用语言复数类别名作为后缀，v3及更早格式仍可通过兼容选项启用。[7] 项目一直保持向后兼容的做法，新版发布可仅通过一层很薄的兼容层替换旧版。[3] 在框架之外，创建者还建立了围绕i18next生态的翻译管理服务。该库以MIT许可发布，在包管理平台上保持较高的周下载量，并由2名开源维护者协作维护。[2][9]
应用
该框架可用于浏览器、Node.js、Deno等JavaScript环境，社区也为其提供了面向React、Angular、Vue.js等前端框架的集成包。[1] 除JavaScript生态外，它还被移植到PHP、iOS、Android等平台，形成一套跨平台的用法约定。[4]
在部署层面，翻译资源既可以打包进应用，也可以通过HTTP请求按需从后端加载，并可选择在本地缓存、按语言检测结果自动切换。[2] 命名空间机制使大型项目能够把译文拆分为多个文件，仅在需要时加载对应部分，避免一次性载入全部语言资源。[1] 在Linux发行版中，该库也以软件包的形式被收录分发。[12]
局限
i18next提供的是一套翻译引擎与配套流程，本身并不解决翻译内容的生产问题。译文的撰写、审校与版本管理需要在框架之外安排，创建者也正是基于这一缺口才另行建立了翻译管理服务。[3]
键值格式对键名有限制。键中不能出现冒号和点号，因为这两个字符被框架用于分隔命名空间与嵌套层级；键名也不会作为缺失译文时的兜底内容，因此不能依赖键本身充当默认文案。[5] 此外，复数类别由语言规则决定，若所用运行环境未提供Intl.PluralRules接口，则需要额外引入垫片，否则会退回旧格式的复数处理方式。[7]
功能覆盖面带来的代价是体积与配置复杂度。框架压缩后约33千字节、gzip压缩后约9千字节，这是因为其中包含了语言检测、译文加载等基本国际化之外的机制。[11] 相应的，语言检测、复数和插值等高级功能的配置存在一定学习成本；对于只使用单一语言或仅需简单键值替换的项目，这类开销可能超出实际需要。[11]
参见
参考资料
- Introduction | i18next documentation [引用日期2026-10-14]
- i18next [引用日期2026-10-14]
- The history of i18next | i18next documentation [引用日期2026-10-14]
- Software:I18next [引用日期2026-10-14]
- Getting started | i18next documentation [引用日期2026-10-14]
- Translation Engine | i18next/i18next | DeepWiki [引用日期2026-10-14]
- JSON Format | i18next documentation [引用日期2026-10-14]
- i18n-pluralization [引用日期2026-10-14]
- i18next - npm Package Security Analysis [引用日期2026-10-14]
- i18next [引用日期2026-10-14]
- comparison-to-others [引用日期2026-10-14]
- 软件包：libjs-i18next（23.7.6-2） [引用日期2026-10-14]