@gravity-ui/i18n-babel-plugin

中文文档
1.5.0发布于 2026/08/12MITTypeScriptCommonJS构建来源已验证近 30 天下载 1.2万

优化翻译文件交付的 Babel 插件 .

中文使用文档
文档目录5 节
  1. 使用量
  2. 设置
  3. 错误
  4. 根号
  5. 文件名Matcher

@gravity-ui/i18n-babel-插图

优化翻译文件交付的 Babel 插件 .

如果你没有用贝布尔,那么 i18n-优化-插件 适合你吗.

变换 i18n.ts 文件 :

  • 从信件中删除元( id, 描述等)
  • 将下标记转换为 html( 当 meta.markdown === true(中文(简体) )
  • 对关键内容应用打字规则

东都:

  • 根据 ICU 信件格式验证语法
  • 编译 ICU 信件格式到 AST
  • 将原始密钥替换为散列( 允许缩短密钥长度)

使用量

安装插件 :

npm install @gravity-ui/i18n-babel-plugin --save-dev

连接插件到构建中 。 实例,如果你在使用 app-builder数字 :

import {defineConfig} from '@gravity-ui/app-builder';

export default defineConfig({
    client: {
        babel: (config) => {
            const plugins = config.plugins ? [...config.plugins] : [];

            return {
                ...config,
                plugins: [
                    ...plugins,
                    require.resolve('@gravity-ui/i18n-babel-plugin')
                ],
            };
        }
    }
});

设置

错误

允许配置 类型规则。 。 。 .

默认使用 DEFAULT_TYPOGRAF_CONFIG 规则.

自定义打字规则的例子:

plugins: [
    require.resolve('@gravity-ui/i18n-babel-plugin', {
        typograf: {
            enabled: ['common/nbsp/afterNumber', 'common/nbsp/afterParagraphMark'],
            disabled: ['common/symbols/cf', 'common/space/trimRight', 'common/space/trimLeft'],
        }
    })
],

无法使用的打字机示例 :

plugins: [
    require.resolve('@gravity-ui/i18n-babel-plugin', {
        typograf: false,
    })
],

根号

允许限制插件的范围 。 插件不会处理超出指定范围的文件 .

类型 : string。 。 。 .

默认 : src。 。 。 .

文件名Matcher

允许使用自定义名称处理翻译文件 .

类型 : FilenameMatcher | FilenameMatcher[]时 FilenameMatcher 为:

  • string —— 与文件路径的结尾相比, 所以 i18n.ts 匹配两者 Component/i18n.ts 财务报告和审定财务报表 Component/component.i18n.ts· ;
  • RegExp ——按常态化路径进行考核(\ → /(三);
  • {type: 'regexp', pattern: string, flags?: string} 以可序列形式(用于 .babelrc / JSON 配置词.

默认 : 'i18n.ts'。 。 。 .

带有自定义文件名的示例 :

plugins: [
    require.resolve('@gravity-ui/i18n-babel-plugin', {
        filenameMatcher: ['i18n.ts', 'keysets.ts'],
    })
],

带有正则表达式的示例( 匹配) Component/component.translations.ts 财务报告和审定财务报表 Component/component.translations.tsx:

plugins: [
    require.resolve('@gravity-ui/i18n-babel-plugin', {
        filenameMatcher: /\.translations\.tsx?$/,
    })
],

同样的正则表达式 .babelrc数字 :

{
  "plugins": [
    ["@gravity-ui/i18n-babel-plugin", {
      "filenameMatcher": {"type": "regexp", "pattern": "\\.translations\\.tsx?$"}
    }]
  ]
}

注意 root 限制仍然适用: 外部的文件 root 即使匹配, 也不会处理 filenameMatcher。 。 。 .

版本与发布记录

@gravity-ui/i18n-babel-plugin 共发布 10 个版本,首次发布于 2025/10/16;过去 12 个月发布了 8 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.5.0latest2026/08/123 个月前
1.4.02026/03/168 个月前
1.3.22026/02/139 个月前
1.3.12026/02/139 个月前
1.3.02026/02/039 个月前
1.2.22025/12/1311 个月前

关于 @gravity-ui/i18n-babel-plugin 的常见问题

@gravity-ui/i18n-babel-plugin 是什么?

优化翻译文件交付的 Babel 插件 .

如何安装 @gravity-ui/i18n-babel-plugin?

在项目目录运行 npm install @gravity-ui/i18n-babel-plugin,或使用 pnpm add / yarn add / bun add。

@gravity-ui/i18n-babel-plugin 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gravity-ui/i18n-babel-plugin 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@gravity-ui/i18n-babel-plugin 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gravity-ui/i18n-babel-plugin 可以商用吗?

@gravity-ui/i18n-babel-plugin 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gravity-ui/i18n-babel-plugin 的下载量有多少?

根据 npm 官方下载统计,@gravity-ui/i18n-babel-plugin 在 2026/10/17 – 2026/11/15 这 30 天内被下载 12,325 次,日均约 411 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gravity-ui/i18n-babel-plugin 还在维护吗?

最新版本 1.5.0 发布于 2026/08/12(3 个月前);至今共发布 10 个版本,其中过去 12 个月发布了 8 个;首次发布于 2025/10/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。