# @bradleyhodges/sfsymbols 中文文档

规范地址：https://npmcn.com/package/%40bradleyhodges/sfsymbols/

版本：8\.1\.3
npm 元数据更新时间：2026-09-08T04:06:42.527Z
中文译文更新时间：2026-11-08T13:22:05.020Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40bradleyhodges/sfsymbols
原文对照：https://npmcn.com/package/%40bradleyhodges/sfsymbols/?lang=original
项目主页：https://github.com/bradleyhodges/sfsymbols#readme
源码仓库：https://github.com/bradleyhodges/sfsymbols

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

- 包体积（解压后）：50.6 MB，32456 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2025-09-23T02:08:45.959Z
- 最新版本发布：2026-09-08T04:06:42.387Z
- 近 30 天下载量：12265（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 6 个）

## 中文简介

苹果公司的SF符号图标用于苹果平台的React应用.

## 安装

```sh
npm install @bradleyhodges/sfsymbols
```

也可以使用：`pnpm add @bradleyhodges/sfsymbols`、`yarn add @bradleyhodges/sfsymbols`、`bun add @bradleyhodges/sfsymbols`

## README

![SF Symbols 8](https://github.com/bradleyhodges/sfsymbols/blob/main/assets/vx-poster-sf-symbols-new-symbols_2x.png?raw=true)

# SF 符号 8

### 苹果公司的SF符号图标用于在苹果平台上构建React/Typescript应用程序.

 ![NPM Downloads by package author](https://img.shields.io/npm-stat/dm/bradleyhodges)[![npmjs package](https://img.shields.io/badge/npmjs-package-red?logo=npm) ](https://www.npmjs.com/package/@bradleyhodges/sfsymbols)[![GitHub repo](https://img.shields.io/badge/github-repo-blue?logo=github)](https://github.com/bradleyhodges/sfsymbols)  
 [![Version: 8.1.3](https://img.shields.io/badge/version-8.1.3-blue.svg)](https://github.com/bradleyhodges/sfsymbols/releases)![Platforms: Next.js – React.js – React Nav](https://img.shields.io/badge/Platforms-Next.js%20|%20React.js%20|%20React%20Native-FF69B4.svg) [![License: MIT](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://github.com/bradleyhodges/sfsymbols/blob/stable/LICENSE)

SF符号是一个由超过7000个符号组成的库,设计上与旧金山无缝地融合,是苹果平台的系统字体.

[特征](https://npmcn.com/package/%40bradleyhodges/sfsymbols/#readme-features-of-this-library) 二. 支助 [版本](https://npmcn.com/package/%40bradleyhodges/sfsymbols/#readme-version) 二. 支助 [可用图标](https://npmcn.com/package/%40bradleyhodges/sfsymbols/#readme-available-icons) 二. 支助 [开始](https://npmcn.com/package/%40bradleyhodges/sfsymbols/#readme--getting-started) 二. 支助 [安装](https://npmcn.com/package/%40bradleyhodges/sfsymbols/#readme-install-the-packages) 二. 支助 [使用量](https://npmcn.com/package/%40bradleyhodges/sfsymbols/#readme-usage) 二. 支助 [大楼](https://npmcn.com/package/%40bradleyhodges/sfsymbols/#readme-building) 二. 支助 [问题](https://github.com/bradleyhodges/sfsymbols/issues) 二. 支助 [调取请求](https://github.com/bradleyhodges/sfsymbols/pulls)

## 本图书馆的特点

-   **8,111个符号** - 包含整个SF符号 8 (β)图标库,外加609个补充品牌图标
-   **可树动** - 每个图标都可以作为独立组件(每个小于1 KB)或捆绑导入导入
-   **类型安全** - 使用 IDE 自动完成的完整类型脚本支持
-   **轻巧** - 只有导入的图标才会在你的捆绑中
-   **反应18/19** - 与最新版本的React合作

## 版本

此软件包已使用来自 **8.0 (135)号版本** - SF 字体版本 `22.0d4e4`。 。 。 .

## 可用图标

本套装包含8,111个图标,其中包括609个补充品牌图标. 所有7 502个 `Regular` 重量图标 [旧金山字体](https://github.com/bradleyhodges/SFWindows) 包含。 其他的权重不包含在这个包中,但图标权重可以通过对向量路径进行中风而更重.

简而言之, **我为这个软件包创建了一个基本的图标浏览器,你可以在这里访问: [bradleyhodges - sfsyms.vercel.app (原始内容存档于2017-03-28)](https://bradleyhodges-sfsymbols.vercel.app/)** [![Screenshot of a comment on a GitHub issue showing an image, added in the Markdown, of an Octocat smiling and raising a tentacle.](https://github.com/bradleyhodges/sfsymbols/blob/main/assets/icon-browser-screenshot.png?raw=true)](https://bradleyhodges-sfsymbols.vercel.app/)

## 开始

此套件具有SF符号8的实际图标和图标数据的特点. 要在 React 应用程序中使用这些图标, 您可以使用 [`sfsymbols-react` 配套软件包](https://www.npmjs.com/package/@bradleyhodges/sfsymbols-react),它暴露了SF符号8图标的方便易用回放组件.

### 安装软件包

您需要安装以下软件包来使用您的工程中的图标 :

-   [`@bradleyhodges/sfsymbols`](https://www.npmjs.com/package/@bradleyhodges/sfsymbols) - 包含实际图标.
-   [`@bradleyhodges/sfsymbols-react`](https://www.npmjs.com/package/@bradleyhodges/sfsymbols-react) - 包含用于使用图标的反射组件.
-   [`@bradleyhodges/sfsymbols-types`](https://www.npmjs.com/package/@bradleyhodges/sfsymbols-types) -(可选)如果需要,包含图标的TypeScript类型.

### 使用量

> \[叹息\] SF符号由苹果公司许可,仅用于苹果平台. **此软件包或其他任何 @ bradleyhodges/ sfsymbols- \* 软件包, 在苹果平台外使用是不允许的 .** 更多信息 : [Xcode 和 Apple SDKs 协议](https://www.apple.com/legal/sla/docs/xcode.pdf#page=6&search=System-Provided%20Images)

```bash
pnpm add @bradleyhodges/sfsymbols@latest @bradleyhodges/sfsymbols-react@latest @bradleyhodges/sfsymbols-types@latest
```

然后可以这样导入项目中的图标 :

```tsx
import { SFIcon } from '@bradleyhodges/sfsymbols-react';
import { sfArrowUpCircleFill } from '@bradleyhodges/sfsymbols';

...

<SFIcon icon={sfArrowUpCircleFill} />
```

> \[TIP\] 见 [sfsymbols-反应](https://github.com/bradleyhodges/sfsymbols-react) 软件包,用于详细了解 `SFIcon` 组件可接受,并如何使用辅助组件自定义React应用程序中的图标外观.

对于更快的模块分辨率,也可以直接导入单个图标. 这是可选的;现有的根进口仍然得到支持,无害环境管理中的树摇.

```tsx
import { sfArrowUpCircleFill } from '@bradleyhodges/sfsymbols/sfArrowUpCircleFill';
```

普通JS 消费者可以使用相同的每相机路径 `require()`。这可以使捆绑集中在选定的图标上。 Root CommunityJS在访问其出口时导入加载图标定义,但捆绑者可能仍然包括整个目录.

## 大楼

-   `pnpm build-icons` 从本地提供的 SVG 归档中生成类型脚本定义.
-   `pnpm build-package` 编译生成 `src` 纳入经验证的无害环境管理、共同JS和申报产出.
-   `pnpm build-package --from-dist` 重建一个没有 SVG 存档的现有发行。 它验证两种格式都同意,保存了SVG数据和元数据,并恢复了被整理的搜索别名. 重复运行不会累积别名.
-   `pnpm build` 保留交互式存档/版本工作流程,并使用相同的软件包发送器.
-   `pnpm test` 运行构建回归测试; `pnpm typecheck` 检查生成源和运出声明,包括免费的归档取出.

包排放阶段和在替换前验证所有产出 `dist`。失败的替换可以恢复先前的分布;如果恢复被阻断,则错误会识别保留的备份目录。 原始的 SVG 生成仍然需要您自己的源归档 .

全数 `pnpm build` 工作流程将未打开的 SVG 保存在 `build/src` 并生成类型脚本 `src` 通过版本更新、汇编、微缩和输出验证。 清理工作只有在这些步骤成功后才能进行,最后删除了原始的SVG输入. 软件包版本文件使用临时文件替换为Windows锁定的有边框的回放;在所请求的版本中已经保存的文件未被更改.

> \[注\] 此寄存器包含构建图标及其各自反应组件所需的脚本. 然而,由于苹果的许可条款,我还没有将实际的图标存档纳入到这个寄存器中,我也不会应要求提供. 这是为了尊重苹果的许可条款,防止任何未经授权使用图标,并避免任何法律问题.

## 常见问题

### @bradleyhodges/sfsymbols 是什么？

苹果公司的SF符号图标用于苹果平台的React应用\.

### 如何安装 @bradleyhodges/sfsymbols？

在项目目录运行 npm install @bradleyhodges/sfsymbols，或使用 pnpm add / yarn add / bun add。

### @bradleyhodges/sfsymbols 支持 TypeScript 吗？

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

### @bradleyhodges/sfsymbols 支持 ESM 还是 CommonJS？

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

### @bradleyhodges/sfsymbols 可以商用吗？

@bradleyhodges/sfsymbols 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @bradleyhodges/sfsymbols 的下载量有多少？

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

### @bradleyhodges/sfsymbols 还在维护吗？

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