# @atlaskit/theme 中文文档

规范地址：https://npmcn.com/package/%40atlaskit/theme/

版本：28\.2\.5
npm 元数据更新时间：2026-10-22T03:50:17.692Z
中文译文更新时间：2026-11-07T02:41:26.064Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40atlaskit/theme
原文对照：https://npmcn.com/package/%40atlaskit/theme/?lang=original
项目主页：https://bitbucket.org/atlassian/atlassian-frontend-mirror#readme
源码仓库：https://bitbucket.org/atlassian/atlassian-frontend-mirror

弃用说明：This package is deprecated and is no longer maintained or supported\.

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

- 包体积（解压后）：125 kB，40 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：react ^18\.2\.0 \|\| ^19\.0\.0
- 首次发布：2017-08-11T08:49:39.274Z
- 最新版本发布：2026-10-14T02:03:10.834Z
- 近 30 天下载量：1889431（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：221（近 12 个月 30 个）

## 中文简介

废旧的公用事业。 取而代之的是使用设计标志和Atlassian设计系统组件.

## 安装

```sh
npm install @atlaskit/theme
```

也可以使用：`pnpm add @atlaskit/theme`、`yarn add @atlaskit/theme`、`bun add @atlaskit/theme`

## README

# 主题

> **折旧:** `@atlaskit/theme` 已贬值。 使用设计符号, Atlassian设计系统 组件,或酌情使用顶层.

## 移徙

-   将颜色、相距、打字、高程和其他造型值替换为设计符号 [`@atlaskit/tokens`](https://atlassian.design/components/tokens)。 。 。 .
-   替换 `layers` 在可能情况下,有Atlas系统分层组件。 当建造一个 低水平覆盖, 使用 [`@atlaskit/top-layer`](https://atlassian.design/components/top-layer)顶端 层管理通过浏览器上层的叠叠叠叠叠叠叠叠; 这不是一个数字 `z-index` 地图 而不是一个即时替换 `layers`。 。 。 .
-   替换 `Theme`, (中文(简体) ), `createTheme`, (中文(简体) ), `getTheme`,及其与设计符号和 支持Atlassian设计系统相关组成部分的定制API。 没有 包式,一对一替换这些遗留的主题API.
-   在不需要替换时,取消直接使用遗留主题常数和类型.

不添加此软件包的新依赖性 .

## 常见问题

### @atlaskit/theme 是什么？

废旧的公用事业。 取而代之的是使用设计标志和Atlassian设计系统组件\.注意：该包已被作者标记为弃用——This package is deprecated and is no longer maintained or supported\.

### 如何安装 @atlaskit/theme？

在项目目录运行 npm install @atlaskit/theme，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.2\.0 \|\| ^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @atlaskit/theme 支持 TypeScript 吗？

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

### @atlaskit/theme 支持 ESM 还是 CommonJS？

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

### @atlaskit/theme 可以商用吗？

@atlaskit/theme 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @atlaskit/theme 的下载量有多少？

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

### @atlaskit/theme 还在维护吗？

最新版本 28\.2\.5 发布于 2026/10/14（24 天前）；至今共发布 221 个版本，其中过去 12 个月发布了 30 个；首次发布于 2017/08/11。作者已将其标记为弃用，新项目建议寻找替代方案。