@zerolith / i18n
国际化为零石,建立在 Intl 没有附带任何东西:引擎已经知道如何为每个语言环境格式化数字、日期、列表和复数,因此包只决定使用哪个语言环境,将其作为信号保存,并提前将消息编目编译为普通函数。
import { applyLocale, createLocale, formatters } from "@zerolith/i18n";
const locale = createLocale({ supported: ["en", "de", "ar"], initial: navigator.languages });
applyLocale(locale); // <html lang dir> follow the signal
const format = formatters(locale.locale);
format.number(1234.5, { style: "currency", currency: "EUR" });
negotiateLocale 和 parseAcceptLanguage 选择支持的最佳语言环境 Accept-Language 头, navigator.languages或一个标记,就像RFC 4647查找的方式一样。
createLocale 保存当前语言环境及其方向作为信号; applyLocale 将它们写入文档。
formatters 包装 Intl.NumberFormat, DateTimeFormat, RelativeTimeFormat, ListFormat, PluralRules,每个区域设置和选项缓存,在调用时读取区域设置信号。
zerolith-i18n 编译MessageFormat 2目录(messages/en.json)分为每个语言环境的一个模块,每个消息和类型化参数都有一个函数,因此语言环境是一个块,不加载消息运行时。
指南在 文档网站.
状态:α。安装与 npm install @zerolith/i18n@alpha; API可能会在1.0之前更改。
文档
- 这个 国际化指南 用作为测试运行的示例解释它。
- 这个 参考 列出从源生成的每个导出。
- 对zerolith不熟悉?这个 教程 一步一步地构建一个应用程序 操场上 在浏览器中运行代码。
许可证
apache - 2.0。看到 LICENSE.
关于 @zerolith/i18n 的常见问题
@zerolith/i18n 是什么?
基于Intl构建的zerolith国际化,没有附带任何内容:语言环境协商和状态、方向和文档语言、缓存格式化器,以及将MessageFormat 2目录转换为每个语言环境模块的编译器
如何安装 @zerolith/i18n?
在项目目录运行 npm install @zerolith/i18n,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zerolith(^0.1.0-alpha.8)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 zerolith-i18n,可以用 npx zerolith-i18n 直接运行。
@zerolith/i18n 支持 TypeScript 吗?
支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。
@zerolith/i18n 支持 ESM 还是 CommonJS?
以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。
@zerolith/i18n 需要什么版本的 Node.js?
package.json 的 engines 字段要求 Node.js >=24.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。
@zerolith/i18n 可以商用吗?
@zerolith/i18n 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。
@zerolith/i18n 还在维护吗?
最新版本 0.1.0-alpha.8 发布于 2026/11/03(今天);至今共发布 13 个版本,其中过去 12 个月发布了 13 个;首次发布于 2026/10/30。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。