# @cmsgov/design-system-core 中文文档

规范地址：https://npmcn.com/package/%40cmsgov/design-system-core/

版本：3\.7\.2
npm 元数据更新时间：2026-08-20T13:48:05.581Z
中文译文更新时间：2026-11-10T04:17:42.608Z
软件包许可：SEE LICENSE IN LICENSE\.md

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

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

弃用说明：This package has been deprecated in favor of @cmsgov/design-system\. See the CMSDS docs \(https://design\.cms\.gov/startup/migrating-v2\) for more information\.

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

- 包体积（解压后）：1.7 MB，421 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：7 个
- peer 依赖：react ^15\.0\.0 \|\| ^16\.0\.0，react-dom ^15\.0\.0 \|\| ^16\.0\.0，prop-types ^15\.0\.0 \|\| ^16\.0\.0
- 首次发布：2017-03-08T21:56:36.180Z
- 最新版本发布：2020-07-08T15:25:59.599Z
- 近 30 天下载量：2501（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：81（近 12 个月 0 个）

## 中文简介

核心Sass/CSS和反应设计系统资产

## 安装

```sh
npm install @cmsgov/design-system-core
```

也可以使用：`pnpm add @cmsgov/design-system-core`、`yarn add @cmsgov/design-system-core`、`bun add @cmsgov/design-system-core`

## README

本套件包含下列设计系统资产: 设计系统 设计系统

-   基础样式
-   公用事业类
-   Sass/CSS和反应组件
-   混音和变量
-   字体和图像

## 安装

```
npm install --save @cmsgov/design-system-core
```

## 使用量

包含的出处文件以 Sass (`.scss`) (中文(简体) ). 你可以加上你的东西 `node_modules` 您 Sass 的目录 [`includePaths`](https://github.com/sass/node-sass#includepaths) 并像这样导入文件 :

```css
@import '@cmsgov/design-system-core/src/index';
```

或导入转录的 CSS :

```css
@import '@cmsgov/design-system-core/dist/index.css';
```

[欲了解更多信息,请查看文件网站.](https://design.cms.gov/)

## 实例

使用中的设计系统实例,可参见: [`examples` 目录](https://github.com/CMSgov/design-system/tree/master/examples) (原始内容存档于2018-09-29). on GitHub.

## 错误和贡献

请 [在 GitHub 上提交一个问题](https://github.com/CMSgov/design-system) 用于任何错误或特性请求.

你也可以读我们的 [捐款额](https://github.com/CMSgov/design-system/blob/master/CONTRIBUTING.md) 学习如何建立本地开发环境,促进设计系统,以及我们的编码指南.

## 文件结构

设计系统沿袭以下变化: [国贸中心](http://thomasbyttebier.be/blog/less-css-mess) (CSS的倒置三角架构). 目标是将CSS写入 [具体](https://developer.mozilla.org/en-US/docs/Web/CSS/Specificity) 秩序。 秩序.

```
├── dist                Compiled CSS and JS
├── fonts
├── images
└── src                 Non-compiled Sass and JSX
    ├── base            Base HTML styles
    ├── components      Sass and React components
    │   ├── Button
    │   └── etc...
    ├── generics        Far reaching selectors
    └── utilities       Functional CSS classes to apply individual traits
```

## 常见问题

### @cmsgov/design-system-core 是什么？

核心Sass/CSS和反应设计系统资产注意：该包已被作者标记为弃用——This package has been deprecated in favor of @cmsgov/design-system\. See the CMSDS docs \(https://design\.cms\.gov/startup/migrating-v2\) for more information\.

### 如何安装 @cmsgov/design-system-core？

在项目目录运行 npm install @cmsgov/design-system-core，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^15\.0\.0 \|\| ^16\.0\.0）、react-dom（^15\.0\.0 \|\| ^16\.0\.0）、prop-types（^15\.0\.0 \|\| ^16\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @cmsgov/design-system-core 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cmsgov\_\_design-system-core 是否存在。

### @cmsgov/design-system-core 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @cmsgov/design-system-core 可以商用吗？

@cmsgov/design-system-core 使用 SEE LICENSE IN LICENSE\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @cmsgov/design-system-core 的下载量有多少？

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

### @cmsgov/design-system-core 还在维护吗？

最新版本 3\.7\.2 发布于 2020/07/08（6 年前）；至今共发布 81 个版本，其中过去 12 个月发布了 0 个；首次发布于 2017/03/09。作者已将其标记为弃用，新项目建议寻找替代方案。