# @betteroffice/xlsx-i18n 中文文档

规范地址：https://npmcn.com/package/%40betteroffice/xlsx-i18n/

版本：0\.5\.1
npm 元数据更新时间：2026-10-27T11:29:11.253Z
中文译文更新时间：2026-11-08T00:23:16.801Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40betteroffice/xlsx-i18n
原文对照：https://npmcn.com/package/%40betteroffice/xlsx-i18n/?lang=original
项目主页：https://betteroffice.dev/
源码仓库：https://github.com/openooxml/betteroffice

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：83.1 kB，25 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-07-19T19:44:38.239Z
- 最新版本发布：2026-10-27T11:29:10.823Z
- 近 30 天下载量：96909（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

共享用于 @ betteroffice/ xlsx React 编辑器的 UI 本地端字符串和类型 .

## 安装

```sh
npm install @betteroffice/xlsx-i18n
```

也可以使用：`pnpm add @betteroffice/xlsx-i18n`、`yarn add @betteroffice/xlsx-i18n`、`bun add @betteroffice/xlsx-i18n`

## README

# @ betteroffice/xlsx-i18n (英语)

用户界面字符串、 语言类型和翻译助手 [`@betteroffice/xlsx-react`](https://www.npmjs.com/package/@betteroffice/xlsx-react) 编辑. `en` 定义 字符串; 其它语言覆盖它们.

## 安装

```bash
bun add @betteroffice/xlsx-i18n
```

## 使用量

把一个地方传给编辑 `i18n` 道具 :

```tsx
import { de } from '@betteroffice/xlsx-i18n';
import { XlsxEditor } from '@betteroffice/xlsx-react';

export function Editor({ file }: { file: Uint8Array }) {
  return <XlsxEditor file={file} i18n={de} />;
}
```

通过传播一个地块来覆盖单个字符串. 缺少的密钥或 `null` 倒计时 英语.

```ts
const custom = { ...de, toolbar: { ...de.toolbar, save: 'Sichern' } };
```

## 语言

`en` (资料来源), `de`, (中文(简体) ), `fr`, (中文(简体) ), `he`, (中文(简体) ), `hi`, (中文(简体) ), `id`, (中文(简体) ), `pl`, (中文(简体) ), `pt-BR`, (中文(简体) ), `tr` 财务报告和审定财务报表 `zh-CN`编辑 出口额 `pt-BR` 财务报告和审定财务报表 `zh-CN` 为: `ptBR` 财务报告和审定财务报表 `zhCN`。 。 。 .

每个地方也是自己的地道 比如说 `@betteroffice/xlsx-i18n/pl`,所以一个应用程序选择 运行时的地盘只能装入它需要的地盘 . `locales` 将每个标记映射到它的字符串和 把他们都捆起来.

## 帮助者

软件包导出类型 `LocaleStrings`, (中文(简体) ), `PartialLocaleStrings`, (中文(简体) ), `Translations`, (中文(简体) ), `TranslationKey`, (中文(简体) ), `LocaleCode` 财务报告和审定财务报表 `TFunction`函数 `createT` 财务报告和审定财务报表 `deepMerge`。 。 。 . 外部反应, 构建输入 `t()` 直接 :

```ts
import { createT, deepMerge, en, de, type LocaleStrings } from '@betteroffice/xlsx-i18n';

const t = createT(deepMerge(en, de) as LocaleStrings, 'de');
t('toolbar.save'); // 'Save'
```

## 文档

-   [Java脚本指南](https://docs.betteroffice.dev/docs/javascript)
-   [`@betteroffice/xlsx-react`](https://www.npmjs.com/package/@betteroffice/xlsx-react)
-   [更改日志](https://github.com/openooxml/betteroffice/blob/main/packages/xlsx-i18n/CHANGELOG.md)

## 常见问题

### @betteroffice/xlsx-i18n 是什么？

共享用于 @ betteroffice/ xlsx React 编辑器的 UI 本地端字符串和类型 \.

### 如何安装 @betteroffice/xlsx-i18n？

在项目目录运行 npm install @betteroffice/xlsx-i18n，或使用 pnpm add / yarn add / bun add。

### @betteroffice/xlsx-i18n 支持 TypeScript 吗？

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

### @betteroffice/xlsx-i18n 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @betteroffice/xlsx-i18n 可以商用吗？

@betteroffice/xlsx-i18n 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @betteroffice/xlsx-i18n 的下载量有多少？

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

### @betteroffice/xlsx-i18n 还在维护吗？

最新版本 0\.5\.1 发布于 2026/10/27（12 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/07/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。