# @docx-editor\.dev/fonts-cjk 中文文档

规范地址：https://npmcn.com/package/%40docx-editor.dev/fonts-cjk/

版本：2\.38\.0
npm 元数据更新时间：2026-11-16T13:53:53.371Z
中文译文更新时间：2026-11-16T13:55:31.438Z
软件包许可：Apache-2\.0 AND OFL-1\.1

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

原始 npm 页面：https://www.npmjs.com/package/%40docx-editor.dev/fonts-cjk
原文对照：https://npmcn.com/package/%40docx-editor.dev/fonts-cjk/?lang=original
项目主页：https://docx-editor.dev/
源码仓库：https://github.com/eigenpal/docx-editor

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

- 包体积（解压后）：16.5 MB，18 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：^20\.16\.0 \|\| \>=22\.3\.0
- 运行依赖：0 个
- 首次发布：2026-09-27T17:54:26.153Z
- 最新版本发布：2026-11-16T13:53:52.971Z
- 近 30 天下载量：127797（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 29 个）

## 中文简介

Noto Sans CJK JP 在@docx-editor.dev/docx-to-pdf和编辑器中为中文,日文和韩文的倒置字体.

## 安装

```sh
npm install @docx-editor.dev/fonts-cjk
```

也可以使用：`pnpm add @docx-editor.dev/fonts-cjk`、`yarn add @docx-editor.dev/fonts-cjk`、`bun add @docx-editor.dev/fonts-cjk`

## README

[![DOCX Editor by EigenPal](https://raw.githubusercontent.com/eigenpal/docx-editor/main/.github/assets/readme-logo-light.svg)](https://www.docx-editor.dev/)

# @docx-editor.dev/fonts-cjk (英语)

这个软件包为中,日,韩文本提供Noto Sans CJK JP. 这个 [`@docx-editor.dev/docx-to-pdf`](https://www.npmjs.com/package/@docx-editor.dev/docx-to-pdf) 软件包将它用作可选倒计时器,编辑器通过 `cjkFonts()` 解决者。 字体文件大约为16 MB,所以它分开发行.

## 安装

使用节点.js `^20.16.0 || >=22.3.0`。用 PDF 转换器及其所需的引擎端口安装软件包:

```bash
npm install @docx-editor.dev/docx-to-pdf @docx-editor.dev/core @docx-editor.dev/fonts-cjk
```

转换器声明 `@docx-editor.dev/fonts-cjk` 作为一种可选的同伴依赖。 使用满足转换器对等依赖范围的版本. PDF导出找不到配置软件包,并从磁盘上读取其字体. 它不对该字体进行网络请求.

## 字体选择

PDF 导出在早期来源缺少所请求的CJK家族或字符时使用此字体.  `fonts`,启用的系统字体、包装替代物,以及 `fallbackFonts` 资源优先。 此字体在文档嵌入字体和 `lastResortFonts`。关于完整顺序,见 [配置 PDF 字体](https://npmcn.com/package/%40docx-editor.dev/docx-to-pdf/docs/fonts.md#choose-a-source)。 。 。 .

默认的glyph倒置列表包括了这个字体. 如果你提供 `glyphFallbacks`,您列表将替换默认值。 对于这个倒计时,请添加一个条目: `family: NOTO_SANS_CJK_JP_FAMILY`, (中文(简体) ), `weight: 400`,以及 `style: 'normal'`。 。 。 .

您可以在安装或提供的字体覆盖您的 CJK 文本时省略此软件包 。 安装了SimSun、Batang和MS Gothic等字体,在 `useSystemFonts` 实值 `true`。如果没有字体覆盖 CJK 字符,导出报告 a `missing-glyph` 诊断。 当这个包没有的时候,诊断器会命名它. 严格的导出失败 .

## 部署软件包

将软件包添加到您的生产依赖中。 保留在服务器捆绑的外部, 这样Node.js就可以在运行时解决它. 保留其 `dist/` 财务报告和审定财务报表 `assets/` 软件包位置的目录 。 在分发软件包时包含其许可证文件 .

缺少或无法读取字体资产报告的已安装软件包 `font-origin-failed`检查 `result.fontResolution.originFailures` 寻找原因 设置 `fontPolicy: 'strict'` 拒绝这些源失败.

部署实例见 [整合 PDF 转换](https://npmcn.com/package/%40docx-editor.dev/docx-to-pdf/docs/integrations.md)。 。 。 .

## 使用编辑器中的字体

对于浏览器编辑器,请在您现有的编辑器依赖性旁边安装此软件包 :

```bash
npm install @docx-editor.dev/fonts-cjk
```

这个 `@docx-editor.dev/fonts-cjk/browser` 进口 `cjkFonts()`,字体解析器,形状与 `packagedFonts()` 财务报告和审定财务报表 `googleFonts()` 从 `@docx-editor.dev/fonts`。放在您喜欢的字体来源之后:

```ts
import { packagedFonts } from '@docx-editor.dev/fonts';
import { googleFonts } from '@docx-editor.dev/fonts/google';
import { cjkFonts } from '@docx-editor.dev/fonts-cjk/browser';

const fonts = [packagedFonts(), googleFonts(), cjkFonts()];
```

第一幅画不等待下载。 编辑器将文档用其他字体来作画,再等这个字体到来后再铺出. 要用其他字体安装, 请通过 `cjkFonts({ loading: 'wait' })`。接收此解析器的文档导出总是等待字体.

如果你能从第三方装入字体, `googleFonts({ cjk: true })` 从 `@docx-editor.dev/fonts/google` 是一种选择。 它为文档使用的每种语言装入一个较小的区域面. 不要合并 `cjk: true` 与 `cjkFonts()`:两个字体都会被下载,列出的出处会先被涂上.

解析器只当文档名称为 `CJK_SUBSTITUTED_FAMILIES`,或其中一个本地化名称在 `LOCALIZED_CJK_FAMILIES`您的捆绑者将字体文件作为资产释放, 解析器从那里获取 。 不向第三方提出要求。 浏览器条目仅为 ECMAScript 模块,因为它通过 `import.meta.url`。 。 。 .

下载失败的调用 `onFailure` 选项,或写控制台警告。 然后文档保留了其他字体.

## 直接使用字体

节点.js条目有这些公共出口:

| 导出 | 类型 | 数值 |
| --- | --- | --- |
| `NOTO_SANS_CJK_JP_FAMILY` | 字符串字义 | `'Noto Sans CJK JP'` |
| `NOTO_SANS_CJK_JP_URL` | `URL` | A 类 `file:` URL 为 `assets/NotoSansCJKjp-Regular.otf`。 。 。 . |
| `CJK_SUBSTITUTED_FAMILIES` | `readonly string[]` | 字体代表的东亚家族. |
| `LOCALIZED_CJK_FAMILIES` | `ReadonlyMap<string, string>` | 本地化的姓氏,被绘制为他们的英文名. |

使用导出的 URL 不构建软件包路径而读取字体 :

```ts
import { readFile } from 'node:fs/promises';
import { NOTO_SANS_CJK_JP_FAMILY, NOTO_SANS_CJK_JP_URL } from '@docx-editor.dev/fonts-cjk';

const bytes = await readFile(NOTO_SANS_CJK_JP_URL);
console.log(NOTO_SANS_CJK_JP_FAMILY, bytes.byteLength);
```

Node.js条目没有将字体捆绑入JavaScript或安装浏览器字体.

## 范围和限制

-   该套件包括一个OpenType字体并有CFF大纲:Noto Sans CJK JP Regular.
-   它的重量是 `400`,其风格是 `'normal'`。 。 。 .
-   它供应了日本的区域面相,没有单独的中国或韩国的区域面相.
-   PDF导出能从这个正则面上合成出粗体和斜体.
-   替换此字体可以更改glyph表单,换行符和分页计数.
-   字体覆盖范围以外的字符仍需要另一个字体.

通过转换器提供自己的字体 `fonts` 当您需要特定区域面相或设计样式时.

## 许可证

包代码使用Apache许可证2.0. 更多信息见 [`LICENSE`](https://npmcn.com/package/%40docx-editor.dev/fonts-cjk/LICENSE)。PDF转换器使用单独的 [EigenPal Pro 许可证](https://npmcn.com/package/%40docx-editor.dev/docx-to-pdf/LICENSE.md)。 。 。 .

该字体使用SIL开放字体许可证,版本1.1. 许可证文本在 [`licenses/NotoSansCJK-OFL.txt`](https://npmcn.com/package/%40docx-editor.dev/fonts-cjk/licenses/NotoSansCJK-OFL.txt)。 。 。 .

-   字体:Noto Sans CJK JP正版,2.004版.
-   版权:© 2014-2021 Adobe (中文(简体) )[http://www.adobe.com/ (中文(简体) )](http://www.adobe.com/)) (中文(简体) ).
-   商标:Noto是Google Inc的商标.
-   资料来源: [`notofonts/noto-cjk`](https://github.com/notofonts/noto-cjk/blob/main/Sans/OTF/Japanese/NotoSansCJKjp-Regular.otf)。 。 。 .

字体文件是未修改的上游二进制. [`assets/sources.json`](https://npmcn.com/package/%40docx-editor.dev/fonts-cjk/assets/sources.json) 记录它的源 URL 和 SHA-256 散列。 PDF 导出时只嵌入文档使用的格子.

## 常见问题

### @docx-editor\.dev/fonts-cjk 是什么？

Noto Sans CJK JP 在@docx-editor\.dev/docx-to-pdf和编辑器中为中文,日文和韩文的倒置字体\.

### 如何安装 @docx-editor\.dev/fonts-cjk？

在项目目录运行 npm install @docx-editor\.dev/fonts-cjk，或使用 pnpm add / yarn add / bun add。

### @docx-editor\.dev/fonts-cjk 支持 TypeScript 吗？

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

### @docx-editor\.dev/fonts-cjk 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @docx-editor\.dev/fonts-cjk 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^20\.16\.0 \|\| \>=22\.3\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @docx-editor\.dev/fonts-cjk 可以商用吗？

@docx-editor\.dev/fonts-cjk 使用 Apache-2\.0 AND OFL-1\.1 许可。声明的许可为 Apache-2\.0 AND OFL-1\.1，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @docx-editor\.dev/fonts-cjk 的下载量有多少？

根据 npm 官方下载统计，@docx-editor\.dev/fonts-cjk 在 2026/10/13 – 2026/11/11 这 30 天内被下载 127,797 次，日均约 4,260 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @docx-editor\.dev/fonts-cjk 还在维护吗？

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

