# @bettercms-ai/icons 中文文档

规范地址：https://npmcn.com/package/%40bettercms-ai/icons/

版本：0\.4\.0
npm 元数据更新时间：2026-10-24T11:23:20.570Z
中文译文更新时间：2026-11-08T00:33:40.675Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40bettercms-ai/icons
原文对照：https://npmcn.com/package/%40bettercms-ai/icons/?lang=original

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

- 包体积（解压后）：848 kB，960 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react ^18\.3 \|\| ^19
- 首次发布：2026-09-28T14:26:14.713Z
- 最新版本发布：2026-10-24T11:23:20.413Z
- 近 30 天下载量：3244（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

BetterCMS图标为React设定:每个图标一个ES模块,一个名称列表,一个可选地图和一个懒惰的加载器.

## 安装

```sh
npm install @bettercms-ai/icons
```

也可以使用：`pnpm add @bettercms-ai/icons`、`yarn add @bettercms-ai/icons`、`bun add @bettercms-ai/icons`

## README

# @ bettercms-ai/相册

BetterCMS图标为React设定:473个图标,每个E单元一个. 每个图标 `<svg data-bcms-icon="<name>">` 大小 `1em` 吸引进来 `currentColor`。 。 。 .

```sh
npm install @bettercms-ai/icons
```

## 进口

| 导入 | 你得到的东西 |
| --- | --- |
| `@bettercms-ai/icons/<name>` | 一个图标,例如. `@bettercms-ai/icons/add-circle` (默认和命名导出). |
| `@bettercms-ai/icons` | 每个图标作为命名导出( E)`AddCircleIcon`, ) 加上: `ICON_NAMES`。 。 。 . |
| `@bettercms-ai/icons/names` | `ICON_NAMES` 编辑 `IconName` 类型,没有反应. |
| `@bettercms-ai/icons/load` | `loadIcon(name)`: 按要求加载一个图标; 未知名称解析到 `null`。 。 。 . |
| `@bettercms-ai/icons/map` | 这个 `icons` 名称地图, `<Icon symbol="…" />`, (中文(简体) ), `IconSymbol`, (中文(简体) ), `IconMap`打开每个图标. |

```tsx
import AddCircleIcon from "@bettercms-ai/icons/add-circle";
import { loadIcon } from "@bettercms-ai/icons/load";

const Icon = await loadIcon(field.ui.icon); // null when the name is not in ICON_NAMES
```

`ICON_NAMES` 按代码点排序,是同一列表的 BetterCMS 接受字段 `ui.icon`。 。 。 .

仅限ES模块. 反应18.3或19是同属依赖.

## 许可证

麻省理工学院. 图标作品保留其最初的麻省理工学院版权通知;参见 `LICENSE`。 。 。 .

## 常见问题

### @bettercms-ai/icons 是什么？

BetterCMS图标为React设定:每个图标一个ES模块,一个名称列表,一个可选地图和一个懒惰的加载器\.

### 如何安装 @bettercms-ai/icons？

在项目目录运行 npm install @bettercms-ai/icons，或使用 pnpm add / yarn add / bun add。

### @bettercms-ai/icons 支持 TypeScript 吗？

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

### @bettercms-ai/icons 支持 ESM 还是 CommonJS？

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

### @bettercms-ai/icons 可以商用吗？

@bettercms-ai/icons 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bettercms-ai/icons 的下载量有多少？

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

### @bettercms-ai/icons 还在维护吗？

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