@carbon/utilities

中文文档
0.29.0发布于 2026/11/04Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 74.7万

利用碳设计系统推动软件产品一致性的公用事业和辅助商

中文使用文档
文档目录7 节
  1. 开始
  2. 维护者信息
  3. 内部模块
  4. 添加工具
  5. 捐款
  6. 许可证
  7. IBM 遥测

@ 碳/ 用户

软件产品之间的一致性 碳设计系统

开始

要安装 @carbon/utilities 在您的项目中,您需要运行 根据命令使用 无数字 :

npm install @carbon/utilities

如果你喜欢 雅伦,使用以下命令 相反:

yarn add @carbon/utilities

维护者信息

本套件采用基于会场的多进式建筑. 支持的公众 API 由两部分组成.

  1. 根切入点
import { utility } from '@carbon/utilities';
  1. 任何带有顶级模块 src/<name>/index.ts 文件
import { utility } from '@carbon/utilities/utility';

评议 结构决定记录(ADR) 关于如何和为什么使用这种方法的更详细情况.

内部模块

下方的一些目录 src/ 标记为内部,不从 包根或作为公共切入点。 这些模块意在使用 仅由其他碳包(例如, @carbon/react, (中文(简体) ), @carbon/web-components(中文(简体) ) 并且不应被外部消费者使用.

内部模块 :

  • src/date-picker/ - 用于反应和Web的共享取相器原始 构成部分

使用碳包的内部模块:

import { utility } from '@carbon/utilities/src/internal-module';

说明: 内部模块不是公共 API 的一部分,可能无需修改 备注。 外部消费者不应依赖这些模块.

添加工具

  1. 创建一个新的顶级目录 src/
  2. 从 : src/<name>/index.ts
  3. 再从这里出口 src/index.ts 也可从下列来源获得: 软件包根
  4. 构建软件包并验证以下生成的产出 es/<name>/index.* 财务报告和审定财务报表 lib/<name>/index.js
src/
  someUtility/
    index.ts
    someUtility.ts

捐款

我们总是寻找贡献者 帮助我们修复错误, 建立新的特性, 或者帮助我们改进项目文件。 如果你有兴趣,肯定 看看我们 贡献指南!

许可证

凭 Apache 2.0 许可证。 。 。 .

IBM Telemetry IBM 遥测

本套件使用 IBM 遥测来收集去识别和匿名的度量衡 数据。 通过安装此包作为依赖, 您同意远程测量 藏书。 选择退出,看 选择退出IBM遥测数据收集。 。 。 . 有关所收集数据的更多信息,请参见: IBM 遥测文档。 。 。 .

版本与发布记录

@carbon/utilities 共发布 58 个版本,首次发布于 2024/09/24;过去 12 个月发布了 35 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.29.0latest2026/11/044 天前
0.29.0-rc.0next2026/11/035 天前
1.0.0-alpha.2v12-alpha2026/10/2812 天前
1.0.0-alpha.12026/10/2218 天前
0.28.02026/10/2119 天前
0.28.0-rc.02026/10/2020 天前

关于 @carbon/utilities 的常见问题

@carbon/utilities 是什么?

利用碳设计系统推动软件产品一致性的公用事业和辅助商

如何安装 @carbon/utilities?

在项目目录运行 npm install @carbon/utilities,或使用 pnpm add / yarn add / bun add。

@carbon/utilities 支持 TypeScript 吗?

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

@carbon/utilities 支持 ESM 还是 CommonJS?

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

@carbon/utilities 可以商用吗?

@carbon/utilities 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@carbon/utilities 的下载量有多少?

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

@carbon/utilities 还在维护吗?

最新版本 0.29.0 发布于 2026/11/04(4 天前);至今共发布 58 个版本,其中过去 12 个月发布了 35 个;首次发布于 2024/09/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。