作者:

Creation:2026-01-21Last update:2026-01-21

将此文档参考到您的 AI 助手ChatGPT Claude DeepSeek Google AI mode Gemini Perplexity Mistral Grok

使用您最喜欢的AI助手总结文档，并引用此页面和AI提供商

此文档已过期，基础版本已在以下日期更新 2026年8月23日.

前往英文文档

版本历史

"添加 comparePaths 实用工具"
v9.0.02026/6/23
"为所有导出统一文档"
v8.0.02026/1/21

此页面的内容已使用 AI 翻译。

查看英文原文的最新版本

编辑此文档

如果您有改善此文档的想法，请随时通过在GitHub上提交拉取请求来贡献。

文档的 GitHub 链接

Copy

复制文档 Markdown 到剪贴板

intlayer 包

Name: Intlayer
Rating: 4.92 (64 reviews)
Author: Intlayer

intlayer 包是 Intlayer 生态系统的核心库。它为在 JavaScript 和 TypeScript 应用中管理多语言内容提供了必要的函数、类型和实用工具。

安装

bash

复制代码

复制代码到剪贴板

npm install intlayer

导出

配置

导入：

tsx

复制代码

复制代码到剪贴板

import "intlayer";

显示表格的所有内容

在弹窗中打开表格以清晰地查看所有数据

变量	类型	说明	相关文档
`configuration`	`IntlayerConfig`	Intlayer 的配置对象。	getConfiguration
`getConfiguration`	`() => IntlayerConfig`	返回 Intlayer 配置对象。(已弃用：请改用 `configuration`)	getConfiguration
`locales`	`Locales[]`	所有受支持的 locales 列表。	-
`requiredLocales`	`Locales[]`	所有必需的 locales 列表。	-
`defaultLocale`	`Locales`	默认语言/区域设置。	-

类型

导入：

tsx

复制代码

复制代码到剪贴板

import "intlayer";

显示表格的所有内容

在弹窗中打开表格以清晰地查看所有数据

类型	描述
`Dictionary`	用于定义字典结构的字典类型。
`DeclarationContent`	（已弃用）请改用 `Dictionary<T>`。
`IntlayerConfig`	定义 Intlayer 配置的类型。
`ContentNode`	字典内容中的节点。
`Locale`	表示 locale 的类型。
`LocalesValues`	locale 的可能取值。
`StrictModeLocaleMap`	具有严格类型检查的 locale 映射。

内容函数

导入：

tsx

复制代码

复制代码到剪贴板

import "intlayer";

显示表格的所有内容

在弹窗中打开表格以清晰地查看所有数据

函数	类型	描述	相关文档
`t` / `getTranslation`	`Function`	根据当前 locale（语言环境）选择内容。	翻译
`enu` / `getEnumeration`	`Function`	根据数量选择内容。	枚举
`cond` / `getCondition`	`Function`	根据布尔条件选择内容。	condition
`gender`	`Function`	根据性别选择内容。	gender
`insert`	`Function`	将值插入到内容字符串中。	insertion
`nest` / `getNesting`	`Function`	嵌套另一个字典。	nesting
`md`	`Function`	处理 Markdown 内容。	markdown
`html`	`Function`	处理 HTML 内容。	html
`file`	`Function`	处理文件内容。	file
`getDictionary`	`Function`	处理类似字典的对象（key, content）。它处理 `t()` 翻译、枚举等。	-
`getIntlayer`	`Function`	基于 `getDictionary`，但会注入从生成的声明中得到的优化版本的字典。	-

本地化实用工具

导入：

tsx

复制代码

复制代码到剪贴板

import "intlayer";

显示表格的所有内容

在弹窗中打开表格以清晰地查看所有数据

函数	类型	描述	相关文档
`getLocale`	`Function`	从字符串或路径检测 locale。	getLocale
`getLocaleLang`	`Function`	获取 locale 的语言部分。	getLocaleLang
`getLocaleName`	`Function`	获取 locale 的显示名称。	getLocaleName
`getLocalizedPath`	`Function`	将规范路径解析为本地化路径。	getLocalizedPath
`getCanonicalPath`	`Function`	将本地化路径解析为规范路径。	getCanonicalPath
`getLocalizedUrl`	`Function`	生成本地化的 URL。	getLocalizedUrl
`getMultilingualUrls`	`Function`	为所有受支持的 locale 生成 URL。	getMultilingualUrls
`getPathWithoutLocale`	`Function`	从路径中移除 locale 前缀。	getPathWithoutLocale
`getPrefix`	`Function`	从路径获取 locale 前缀。	getPrefix
`comparePaths`	`Function`	忽略区域设置比较两个路径。	comparePaths
`normalizePath`	`Function`	将路径规范化为与区域设置无关的路径。	comparePaths
`getHTMLTextDir`	`Function`	获取文本方向（LTR/RTL）。	getHTMLTextDir
`validatePrefix`	`Function`	验证区域设置前缀。	validatePrefix

浏览器工具

导入：

tsx

复制代码

复制代码到剪贴板

import "intlayer";

显示表格的所有内容

在弹窗中打开表格以清晰地查看所有数据

函数	类型	描述
`getBrowserLocale`	`Function`	检测浏览器的首选区域设置。
`getCookie`	`Function`	检索 cookie 值。
`getLocaleFromStorage`	`Function`	从存储中检索区域设置。
`setLocaleInStorage`	`Function`	将区域设置保存到存储中。

格式化器

导入：

tsx

复制代码

复制代码到剪贴板

import "intlayer";

显示表格的所有内容

在弹窗中打开表格以清晰地查看所有数据

函数	描述
`number`	格式化数字。
`currency`	格式化货币值。
`percentage`	格式化百分比。
`compact`	以简短形式格式化数字。
`date`	格式化日期。
`relativeTime`	格式化相对时间。
`units`	格式化带单位的数值。
`Intl`	标准 Intl 对象。

打包优化 getIntlayer