@docx-editor.dev/fonts-cjk

中文文档
2.38.0发布于 2026/11/16Apache-2.0 AND OFL-1.1TypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 12.8万

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

中文使用文档
文档目录7 节
  1. 安装
  2. 字体选择
  3. 部署软件包
  4. 使用编辑器中的字体
  5. 直接使用字体
  6. 范围和限制
  7. 许可证

DOCX Editor by EigenPal

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

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

安装

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

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 字体。 。 。 .

默认的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 转换。 。 。 .

使用编辑器中的字体

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

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

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

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_URLURLA 类 file: URL 为 assets/NotoSansCJKjp-Regular.otf。 。 。 .
CJK_SUBSTITUTED_FAMILIESreadonly string[]字体代表的东亚家族.
LOCALIZED_CJK_FAMILIESReadonlyMap<string, string>本地化的姓氏,被绘制为他们的英文名.

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

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。PDF转换器使用单独的 EigenPal Pro 许可证。 。 。 .

该字体使用SIL开放字体许可证,版本1.1. 许可证文本在 licenses/NotoSansCJK-OFL.txt。 。 。 .

字体文件是未修改的上游二进制. assets/sources.json 记录它的源 URL 和 SHA-256 散列。 PDF 导出时只嵌入文档使用的格子.

版本与发布记录

@docx-editor.dev/fonts-cjk 共发布 29 个版本,首次发布于 2026/09/28;过去 12 个月发布了 29 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.38.0latest2026/11/16今天
2.38.0-canary.20261116033356.sha-2662bd1canary2026/11/16今天
2.38.0-canary.20261115032819.sha-05856f62026/11/151 天前
2.38.0-canary.20261114032659.sha-cdc64af2026/11/142 天前
2.38.0-canary.20261113032851.sha-e2cbc552026/11/133 天前
2.37.02026/11/115 天前

其他发布通道:bootstrap → 0.0.1,canary → 2.38.0-canary.20261116033356.sha-2662bd1。

关于 @docx-editor.dev/fonts-cjk 的常见问题

@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 和提交记录判断。