@carbon/react

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

碳设计系统的反应组件

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. 图标
  4. 捐款
  5. 许可证
  6. IBM 遥测

@ 碳/ 反应

为碳设计系统反应组件.

安装

npm install @carbon/react

如果您在应用程序中编译了碳样式, 请安装 达特萨斯 还:

npm install sass

关于Sass配置,见Carbon的 Sass 文档。 。 。 .

包含类型脚本声明.

使用量

这个 @carbon/react 软件包为碳设计提供组件和图标 系统.

要使用一个组件,可以直接从包中导入:

import { Button } from '@carbon/react';

function MyComponent() {
  return <Button>Example usage</Button>;
}

要包含所有碳样式, 请使用 :

@use '@carbon/react';

要包含特定组件的样式,请使用:

@use '@carbon/react/scss/components/button';

关于现有组件的全部清单,见我们 故事书。 。 。 .

图标

这个 @carbon/react 软件包还提供了可以包含的图标组件 在你的项目。 您可以从 @carbon/react/icons 切入点 :

import { Add } from '@carbon/react/icons';

function MyComponent() {
  return <Add />;
}

可用图标的完整列表见Carbon 图标库。 。 。 .

捐款

见 贡献指南。 。 。 .

许可证

凭 Apache 2.0 许可证。 。 。 .

IBM Telemetry IBM 遥测

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

版本与发布记录

@carbon/react 共发布 337 个版本,首次发布于 2021/07/31;过去 12 个月发布了 61 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.120.0latest2026/11/044 天前
1.120.0-rc.0next2026/11/035 天前
2.0.0-alpha.5v12-alpha2026/10/2812 天前
2.0.0-alpha.42026/10/2218 天前
1.119.02026/10/2119 天前
1.119.0-rc.02026/10/2020 天前

其他发布通道:beta → 0.1.0,v12-alpha → 2.0.0-alpha.5,next → 1.120.0-rc.0。

关于 @carbon/react 的常见问题

@carbon/react 是什么?

碳设计系统的反应组件

如何安装 @carbon/react?

在项目目录运行 npm install @carbon/react,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^16.8.6 || ^17.0.1 || ^18.2.0 || ^19.0.0)、react-is(^16.13.1 || ^17.0.2 || ^18.3.1 || ^19.0.0)、react-dom(^16.8.6 || ^17.0.1 || ^18.2.0 || ^19.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@carbon/react 支持 TypeScript 吗?

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

@carbon/react 支持 ESM 还是 CommonJS?

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

@carbon/react 可以商用吗?

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

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

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

@carbon/react 还在维护吗?

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