# @hanzo/font 中文文档

规范地址：https://npmcn.com/package/%40hanzo/font/

版本：1\.9\.6
npm 元数据更新时间：2026-10-30T06:37:31.389Z
中文译文更新时间：2026-11-17T08:16:46.870Z
软件包许可：SIL OPEN FONT LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40hanzo/font
原文对照：https://npmcn.com/package/%40hanzo/font/?lang=original
项目主页：https://hanzo.ai/
源码仓库：https://git.hanzo.ai/hanzoai/font

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

- 包体积（解压后）：13.1 MB，120 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：next \>=13\.2\.0
- 首次发布：2026-08-23T01:41:43.670Z
- 最新版本发布：2026-10-30T06:37:31.189Z
- 近 30 天下载量：15878（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

Zen)——"花野"类型家族:sans,单相和像素,并有品牌预设和a个被子.

## 安装

```sh
npm install @hanzo/font
```

也可以使用：`pnpm add @hanzo/font`、`yarn add @hanzo/font`、`bun add @hanzo/font`

## README

# Zen, Zen 摩诺 & Zen等

禅是"汉藏"类型家族,由SIL开放字体许可证下. 每一个版权 许可证要求为 `LICENSE.txt`在二进制船旁边.

禅是桑色色相型相,为可辨和简单而设计. 它是现代的,几何的,基于经典的瑞士打字原理. 其被设计用于体型复制,头条,标志,海报等大型显示尺寸.

禅道道是一相相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 它被设计用于代码编辑器,图表,终端,以及提供代码的其他文本界面.

Zen Pixel是一个以五个独特的以像素为基础的变体为特色的显示型相克家族,每个变体具有鲜明的视觉风格. 它的设计是为了装饰性地用于头条,标志,以及其它需要像素美学的显示上下文.

### 安装

```sh
pnpm add @hanzo/font
```

### 与 Next.js 一起使用

`Zen` 从 `@hanzo/font/sans`, (中文(简体) ), `ZenMono` 可见于 `@hanzo/font/mono`,而"禅像素"变体从 `@hanzo/font/pixel`全部为 `NextFontWithVariable` 实例。 你可以多学一点 [读取 `next/font` 文档](https://nextjs.org/docs/app/building-your-application/optimizing/fonts)。 。 。 .

#### 禅像素变体

Zen Pixel包括五个不同的变体,每个变体分别导出:

| 导出 | CSS 变量 | 说明 |
| --- | --- | --- |
| `ZenPixelSquare` | `--font-zen-pixel-square` | 平方像素形状 |
| `ZenPixelGrid` | `--font-zen-pixel-grid` | 基于网格的像素图案 |
| `ZenPixelCircle` | `--font-zen-pixel-circle` | 圆形像素形状 |
| `ZenPixelTriangle` | `--font-zen-pixel-triangle` | 三角像素形状 |
| `ZenPixelLine` | `--font-zen-pixel-line` | 基于线的像素图案 |

```jsx
import {
  ZenPixelSquare,
  ZenPixelGrid,
  ZenPixelCircle,
  ZenPixelTriangle,
  ZenPixelLine,
} from "@hanzo/font/pixel";
```

#### 应用路由器

单位 `app/layout.js`数字 :

```jsx
import { Zen } from "@hanzo/font/sans";

export default function RootLayout({ children }) {
  return (
    <html lang="en" className={Zen.className}>
      <body>{children}</body>
    </html>
  );
}
```

#### 页面路由器

单位 `pages/_app.js`数字 :

```jsx
import { Zen } from "@hanzo/font/sans";

export default function MyApp({ Component, pageProps }) {
  return (
    <main className={Zen.className}>
      <Component {...pageProps} />
    </main>
  );
}
```

如果你使用的版本 Next.js 超过15,然后在 `next.config.js` 或者说 `next.config.mjs` 添加:

```diff
/** @type {import('next').NextConfig} */
const nextConfig = {
  reactStrictMode: true,
+  transpilePackages: ["@hanzo/font"],
};

export default nextConfig;
```

这样做是为了纠正错误,例如:

-   `TypeError: next_font_local__WEBPACK_IMPORTED_MODULE_0___default(...) is not a function`
-   `SyntaxError: Cannot use import statement outside a module`

#### 有尾风CSS

所有禅字型都可以通过CSS变量来使用.

-   `Zen`数字 : `--font-zen-sans`
-   `ZenMono`数字 : `--font-zen-mono`
-   `ZenPixelSquare`数字 : `--font-zen-pixel-square`
-   `ZenPixelGrid`数字 : `--font-zen-pixel-grid`
-   `ZenPixelCircle`数字 : `--font-zen-pixel-circle`
-   `ZenPixelTriangle`数字 : `--font-zen-pixel-triangle`
-   `ZenPixelLine`数字 : `--font-zen-pixel-line`

单位 `app/layout.js`数字 :

```jsx
import { Zen } from "@hanzo/font/sans";
import { ZenMono } from "@hanzo/font/mono";
import { ZenPixelSquare } from "@hanzo/font/pixel";

export default function RootLayout({ children }) {
  return (
    <html
      lang="en"
      className={`${Zen.variable} ${ZenMono.variable} ${ZenPixelSquare.variable}`}
    >
      <body>{children}</body>
    </html>
  );
}
```

##### 尾风 CSS V4

然后进入 `tailwind.css`数字 :

```css
@theme {
  /* rest of your theme config */

  --font-sans: var(--font-zen-sans);
  --font-mono: var(--font-zen-mono);
  --font-pixel-square: var(--font-zen-pixel-square);
  --font-pixel-grid: var(--font-zen-pixel-grid);
  --font-pixel-circle: var(--font-zen-pixel-circle);
  --font-pixel-triangle: var(--font-zen-pixel-triangle);
  --font-pixel-line: var(--font-zen-pixel-line);

  /* rest of your theme config */
}
```

##### 尾风 CSS V3

然后进入 `tailwind.config.js`数字 :

```javascript
module.exports = {
  theme: {
    extend: {
      fontFamily: {
        sans: ["var(--font-zen-sans)"],
        mono: ["var(--font-zen-mono)"],
        "pixel-square": ["var(--font-zen-pixel-square)"],
        "pixel-grid": ["var(--font-zen-pixel-grid)"],
        "pixel-circle": ["var(--font-zen-pixel-circle)"],
        "pixel-triangle": ["var(--font-zen-pixel-triangle)"],
        "pixel-line": ["var(--font-zen-pixel-line)"],
      },
    },
  },
};
```

### 阿拉伯语

禅画出拉丁语和西里尔语,没有阿拉伯语. `@hanzo/font/css` 携带3个阿拉伯文 以阿拉伯文盟誓 `unicode-range` (U+0600-06FF,U+0750-077F, U+FB50–FDFF, U+FE70–FEFC),所以一个没有阿拉伯语的页面从不要求一个:

| 家属 | 文件 | 宽度2 |
| --- | --- | --- |
| `Noto Kufi Arabic` | `fonts/arabic/NotoKufiArabic-Variable.woff2`时,100-900小时 | 94.7克朗 |
| `Noto Sans Arabic` | `fonts/arabic/NotoSansArabic-Variable.woff2`时,100-900小时 | 132.5 KB (韩语) |
| `IBM Plex Sans Arabic` | `fonts/arabic/IBMPlexSansArabic-<Weight>.woff2`,100-700页 | 70-75 KB a重量 |

默认( E)`Noto Kufi Arabic`,还有 `var(--font-zen-arabic)`) 将按 `Zen` 财务报告和审定财务报表 `Zen Mono` 也一样 `font-family: Zen` 设置阿拉伯语,没有其他更改。 改为: 在另一伙人中安放阿拉伯语,并说出在禅宗之前的名字: `font-family: 'IBM Plex Sans Arabic', Zen, sans-serif`。 。 。 .

每个同伴都画阿拉伯文字的每封信 汉佐船写 (阿拉伯语、波斯语、达里语、乌尔都语、普什图语、信德语、索拉尼库尔德语、维吾尔语、沙赫穆希语) 旁遮普语; `scripts/arabic.py` 拒绝一张没有的脸。 开罗,Redex Pro和 Rubik被测量了,没有出现在这里:每个字母都遗漏了普什图语、信德语、库尔德语或 维吾尔文.

诺托相被切为阿拉伯块,可变于禅重轴上. IBM 棱镜 Sans 阿拉伯语是 IBM 自己的woff2, 每克一个文件, 字节表示字节: OFL 储备 名称“Plex”,一个子集是一个可能不携带的被修改的版本。 默认 是一个超过100-900的单个可变文件,因为单个家族组合中的面孔 当每个描述器,但范围是相等的, 所以Plex是用自己的名字提供的 只有这个 这些都不是我们的:每个都保留自己的名字和通知在SIL Open字体下 许可证( E)`fonts/arabic/OFL.txt` 对于野藤, `fonts/arabic/OFL-Plex.txt` 用于Plex),以及 `scripts/arabic.py` 由承诺和验收来重建它们 这个 下个/font绑定只携带禅.

### 许可证

Zen字体家族自由并开源 [SIL 打开字体许可证](https://npmcn.com/package/LICENSE.txt)。 。 。 . 阿拉伯的同伴是野藤项目的(`dist/fonts/arabic/OFL.txt`)和IBM'(英语:`dist/fonts/arabic/OFL-Plex.txt`),持同一张许可证.

## 常见问题

### @hanzo/font 是什么？

Zen\)——"花野"类型家族:sans,单相和像素,并有品牌预设和a个被子\.

### 如何安装 @hanzo/font？

在项目目录运行 npm install @hanzo/font，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：next（\>=13\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @hanzo/font 支持 TypeScript 吗？

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

### @hanzo/font 支持 ESM 还是 CommonJS？

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

### @hanzo/font 可以商用吗？

@hanzo/font 使用 SIL OPEN FONT LICENSE 许可。声明的许可为 SIL OPEN FONT LICENSE，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @hanzo/font 的下载量有多少？

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

### @hanzo/font 还在维护吗？

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

