# @aphrody/m3-fonts 中文文档

规范地址：https://npmcn.com/package/%40aphrody/m3-fonts/

版本：1\.4\.7
npm 元数据更新时间：2026-10-23T03:52:28.496Z
中文译文更新时间：2026-11-08T05:36:21.523Z
软件包许可：Apache-2\.0 AND OFL-1\.1

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

原始 npm 页面：https://www.npmjs.com/package/%40aphrody/m3-fonts
原文对照：https://npmcn.com/package/%40aphrody/m3-fonts/?lang=original
项目主页：https://github.com/aphrody-labs/bun-distribution/tree/os/packages/m3-fonts#readme
源码仓库：https://github.com/aphrody-labs/bun-distribution

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

- 包体积（解压后）：41 MB，81 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-09-27T19:32:42.190Z
- 最新版本发布：2026-10-23T03:52:28.318Z
- 近 30 天下载量：1888（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

Apprody M3 型号: Google Sans Flex, Google Sans Code, Roboto Flex, Roboto Mono 和 有日本倒数符(Noto Sans JP, M PLUS 1 Code)的材料符号为@font-face CSS并打出一份清单.

## 安装

```sh
npm install @aphrody/m3-fonts
```

也可以使用：`pnpm add @aphrody/m3-fonts`、`yarn add @aphrody/m3-fonts`、`bun add @aphrody/m3-fonts`

## README

# @aphrody/m3-fonts (英语)

Apprody M3 型号为 `@font-face` CSS和打出的名单:Google Sans Flex,Google Sans代码,Roboto Flex, 机器人摩诺和材料符号,有日语回放(Noto Sans JP,M PLUS 1 Code).

```sh
bun add @aphrody/m3-fonts
```

```ts
import "@aphrody/m3-fonts/fonts.css"; // Latin core faces
import { FONT_STACKS } from "@aphrody/m3-fonts";

document.body.style.fontFamily = FONT_STACKS.brand;
```

许可证:Apache-2.0和OFL-1.1(`LICENSE` 对于代码, `fonts/*-OFL.txt` 为打字机。 安装指南 : [文件/材料/立方米/INSTALL.md](https://github.com/aphrody-labs/bun-distribution/blob/os/docs/material/m3/INSTALL.md)。 。 。 .

| 导入 | 目录 |
| --- | --- |
| `@aphrody/m3-fonts` | `FONTS`, (中文(简体) ), `SYMBOLS_FULL`, (中文(简体) ), `SYMBOL_SUBSET_NAMES`, (中文(简体) ), `FONT_STACKS`, (中文(简体) ), `SUBSETS`, (中文(简体) ), `SUBSET_JOBS`, (中文(简体) ), `fontFaceCss`, (中文(简体) ), `faceRule`, (中文(简体) ), `renderStylesheet`, (中文(简体) ), `UPSTREAM_DIR` |
| `@aphrody/m3-fonts/fonts.css` | 拉丁核心面( 总是导入, < 3 MiB) |
| `@aphrody/m3-fonts/fonts-jp.css` | 被日本面孔所打乱 `unicode-range` |
| `@aphrody/m3-fonts/fonts-symbols.css` | 材料符号子集:工作空间使用的264图标,每个轴被保留(opt-in; `@aphrody/m3-icons` 制作 SVG ) |
| `@aphrody/m3-fonts/fonts-symbols-full.css` | 完整的材料符号可变字体( opt- in, 每个图标) |
| `@aphrody/m3-fonts/fonts/*` | 字体文件 |

文件 :

-   `fonts/web/*.woff2`: 子集服务于浏览器( 有轨迹), 记录于 `src/subsets.json`。 。 。 . `MaterialSymbols{Outlined,Rounded,Sharp}-subset.woff2` 保存图标 `src/symbols-subset.json` (181起,246起) 和159 KB 而不是 3.9、 5.3 和 3.5 MB)作为连接和私人使用区编码点,带有FILL, wght, GRAD和行动轴 列表以外的图标作为其名称: 导入 `fonts-symbols-full.css` 换句话说.
-   `fonts/*.ttf`, (中文(简体) ), `fonts/*-OFL.txt`:跟踪可变来源和许可证.
-   `fonts/upstream/`: Google Sans Flex/代码来源(叉子) `aphrody-labs/fonts` 联 合 国 `google/fonts`和 材料符号( E)`material-symbols@0.44.8`,构建 Rust 图标模块。 未跟踪 : `bun scripts/m3/fonts-sync.ts` 在寄存器根获取它们, 验证每个 sha256 和大小 被钉住 `fonts.lock.json` (单位:千美元)`--check` (仅核实).

脚本 : `gen` (仪表), `subset` (fontTools through uv, ) (fontTools through u, `scripts/subset.py`, (中文(简体) ), `symbols:names` (重新扫描子集保存的图标名称的工作空间;); `--check` 报告一份陈旧的清单, `typecheck`, (中文(简体) ), `test` (fonts同步,然后是清单,文件,锁和样式表检查).

## 常见问题

### @aphrody/m3-fonts 是什么？

Apprody M3 型号: Google Sans Flex, Google Sans Code, Roboto Flex, Roboto Mono 和 有日本倒数符\(Noto Sans JP, M PLUS 1 Code\)的材料符号为@font-face CSS并打出一份清单\.

### 如何安装 @aphrody/m3-fonts？

在项目目录运行 npm install @aphrody/m3-fonts，或使用 pnpm add / yarn add / bun add。

### @aphrody/m3-fonts 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aphrody\_\_m3-fonts 是否存在。

### @aphrody/m3-fonts 支持 ESM 还是 CommonJS？

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

### @aphrody/m3-fonts 可以商用吗？

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

### @aphrody/m3-fonts 的下载量有多少？

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

### @aphrody/m3-fonts 还在维护吗？

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