# @cssints/color-names 中文文档

规范地址：https://npmcn.com/package/%40cssints/color-names/

版本：0\.35\.1
npm 元数据更新时间：2026-11-07T14:55:33.805Z
中文译文更新时间：2026-11-11T03:54:33.131Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40cssints/color-names
原文对照：https://npmcn.com/package/%40cssints/color-names/?lang=original
项目主页：https://cssints.dev/
源码仓库：https://github.com/alexeiaccio/css-in-ts-compiler

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

- 包体积（解压后）：1.5 MB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：2 个
- peer 依赖：cssints ^0\.35\.0
- 首次发布：2026-10-21T14:24:27.689Z
- 最新版本发布：2026-11-07T14:55:33.507Z
- 近 30 天下载量：6950（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

Cssints 的颜色名称列表: 以十六进制颜色命名( “ tagerine ” ), 在 hue 扇区中, 完成时间不长

## 安装

```sh
npm install @cssints/color-names
```

也可以使用：`pnpm add @cssints/color-names`、`yarn add @cssints/color-names`、`bun add @cssints/color-names`

## README

# @ cssints/ 颜色名称

这个 [颜色名称列表](https://github.com/meodai/color-names) (单位:千美元)[名称. color.pizza](https://names.color.pizza/),颜色在 `/color/<name>/`用于 [点缀](https://npmcn.com/package/README.md): 颜色名称作为十六进制颜色,作为成员 `cssints/plugin` `scope()`31 939个名字,无 运行时间. `named(name)` 使用任何名称; `colorNames.<sector>(name)` 一个hue区同名,所以一个编辑 完成是几千个名字,而不是31 939个。 仅构建时间:工作表持有十六进制,数据从未到达 客户.

```ts
import { bg, color, cn } from "cssints" with { type: "cssints" };
import { colorNames, named } from "@cssints/color-names" with { type: "cssints" };

export const tag = cn(color(named("tangerine")), bg(named("midnight-blue")));
export const flag = color(colorNames.red("ferrari-red"));
export const both = color(colorNames.orange("orange-red"));
export const grey = color(colorNames.neutral("abalone"));
export const brown = color(colorNames.brown("chocolate"));
export const css = color("lime"); // the CSS keyword, not the list's Lime
export const bad = color(named("tangerin")); // error: did you mean tangerine?
export const wrong = color(colorNames.red("abalone")); // error: "abalone" is in neutral
```

```css
@layer _.a {
  ._h4vhuh {
    color: #ff9300;
  }
  ._19lu36g {
    background-color: #020035;
  }
  ._h4q7xz {
    color: #ff2800;
  }
  ._h428z9 {
    color: #fe4401;
  }
  ._g9cy5w {
    color: #f8f3f6;
  }
  ._ethye4 {
    color: #d2691e;
  }
  ._1b7kjqn {
    color: lime;
  }
}
```

## 名称

一个名字是列表的关键: NFC, 小写, `&` 改为 `and`,删除了所有字符 字母或数字 `-`修剪过 因此,一个键是字母(accents keeped),数字和连字符: `tangerine`, (中文(简体) ), `100-mph`, (中文(简体) ), `rosé`, (中文(简体) ), `pi²`, (中文(简体) ), `pepper-and-spice`。 。 。 . `Name` 是所有31,939个密钥的结合, 后面有一个别名, 所以一个错误消息说 `Name` 而不是工会 名单中有一个关键相撞`World’s Away` 财务报告和审定财务报表 `Worlds Away` 都给 `worlds-away`保留 缩写的连字符 : `world-s-away`。 。 。 .

未知名称是类型中的一个错误, 以及一个在三个编辑中命名最近的密钥的构建错误 (单位:千美元)`colornames: no colour name "tangerin", did you mean tangerine?`) (中文(简体) ).

## 部门

每个部门一名成员: `red`, (中文(简体) ), `orange`, (中文(简体) ), `yellow`, (中文(简体) ), `green`, (中文(简体) ), `cyan`, (中文(简体) ), `blue`, (中文(简体) ), `purple`, (中文(简体) ), `pink`, (中文(简体) ), `brown`, (中文(简体) ), `neutral`。 。 。 .

**规矩.** 在名称中一个彩色的单词决定了扇形,无论它的颜色是怎样的: `ferrari-red` 进入 `red` 虽然它的口香糖是橙色的 单词是完整的单词,在非字母的事物上分出: `redwood` 财务报告和审定财务报表 `bored` 没有 `red`. 字为红色,橙色,黄色,绿色,青色,蓝色,紫色,粉色和褐色;灰色,灰色,白色 黑色为 `neutral`。一个带有多个颜色单词的名称在 **每个** (154个名称): `orange-red` 进入 `orange` 内 `red`。 。 。 .

无色词的名字被其颜色的花色放入了oklch:在0.02铬以下 `neutral`,然后在 低于0.7光度的橙黄色波段是 `brown` (褐色为深橙色或黄色. 切口,调取 14.61.0版本:

| 部门 | 色调( oklch ) | 名称 |
| --- | --- | --- |
| `red` | 30°以下 | 3 070个 |
| `orange` | 30°至70° | 2 835个 |
| `yellow` | 70°至105° | 4 179个 |
| `green` | 105°到165° | 4 607个 |
| `cyan` | 165°至215° | 1 805个 |
| `blue` | 215°至265° | 3 570个 |
| `purple` | 265°至330° | 2 269个 |
| `pink` | 330°至360° | 1 736 名人员 |
| `brown` | 40°至105°,光度低于0.7 | 3,194个 |
| `neutral` | 0.02下铬 | 4 828个 |

31,939个地名有32,093个区位: 7,703个地名有彩字(其中154个有数个),24,236个由 和2,850的字和字不一致。 另一个扇区的名称是类型中的一个错误,是构建错误 指定其所在区域(`colornames: "abalone" is in neutral`) (中文(简体) ).

削减不是第一次:名单本身的粗略削减(`red` 20°以下, `orange` 至55°, `yellow` 至110°, 0.03下铬,无 `brown`(中文(简体) ) `yellow` 拥有6 657个名字和 `neutral` 7,677,两者都太大,无法用编辑器扫描. `brown` 是修正的扇区 `yellow` 棕色是大部分;没有棕褐色,最大的部分将保留在6000个名字之上, 和有花色的颜色不能称为中性. `neutral` 保持最大的成员 通过它的染色体切单独,即 名单中的近亲之处.

## CSS 关键词

在148个CSS命名的颜色中,63个有其拼写匹配的列表名称,忽略了大小写和平分,其同名 十六进制( x)`red` #ff0000, (英语), `orange` #ffa500; 63有这样的列表名称有一个 **不同** 六分法;和 22 无`gray`, (中文(简体) ), `slategray`, (中文(简体) ), `deeppink`, (中文(简体) ), `dimgray`, (中文(简体) ), `lightgray`, (中文(简体) ), `slateblue`(中文(简体) ). `named()` 解决列表名称,所以 `named("green")` 是列表的绿色 # 00ff00, 而不是 CSS `#008000`,以及 `named("lime")` #aaff32,没有 `#00ff00`。保留 CSS 关键词 可达到字符串 : `color("green")` 指纹 `color: green`。 。 。 .

## `nearest()`

`@cssints/color-names/nearest` 是反向检索:最接近颜色的名称,由CIEDE2000在Lab上显示,作为列表 拥有 API( api.color.pizza/v1) 匹配. **仅构建时间**:它导入整个列表和culori的颜色数学,所以 模块不能导入浏览器(从软件包根直接导出会将数据放入 捆绑). 引擎没有这种模块的标记; 子路径和README线是标记, 至于 `@cssints/tokens`套装和 `lacking`编号 :`inGroup` 帮助者 `cssints/plugin`。 。 。 .

```ts
import { nearest } from "@cssints/color-names/nearest";

nearest("#3b82f6"); // { name: "dodger-blue", hex: "#3e82fc", distance: 0.93 }
nearest("not a colour"); // undefined
```

## 类型

2026-10-17年测量(tsc 5.9.3和tsgo 7.0.0-dev,每行一个文件 `Name` 化名,以及 成员通过 `cssints/plugin`:

| 大小写 | 密钥 | 类型 | 证据 | 检查( tsc) | 完成( 温暖) |
| --- | --- | --- | --- | --- | --- |
| 纯粹的结合, `named(name: Name)` | 31 939个 | 63 971美元 (单位:千美元) | 0 个 | 零点10分 | —— 说 |
| 普通的结合,最大的部门 | 4 828个 | 9 749个 | 0 个 | 0.05 s (简体中文) | —— 说 |
| `scope()` 委员, `arg<Name>()` | 31 939个 | 90,759 (中文(简体) ) | 37 214 (中文(简体) ) | 0.65 s (中文(简体) ) | 31 939分(10分钟) |
| `scope()` 成员,最大的部门 | 4 828个 | 36,572条 | 37 214 (中文(简体) ) | 0.59 门 | 4 828分(1毫秒) |

联盟成本类型,而非即时:两条瞄准镜行共用37,214个即时(引擎本身的类型),以及 他们的检查时间 在噪音中是一样的。 部门购买的是完成清单,该清单短了6.6倍 大约十倍的速度。 这些名字中有一整套代号没有被取出:31,935 DTCG留下了15到26 s来检查.

## 数据

`src/<sector>.ts` 由 `scripts/generate.ts` 从 [颜色名称列表](https://github.com/meodai/color-names) 软件包 **14.61.0 (中文(简体) )** (一个依赖;列表本身没有被复制到寄存器中,投影是). 每个文件都是一个 `as const` 六分之六的钥匙记录加上写出的关键工会,因此,声明 建设者会持有工会(548 kB) 而不是记录(2.2 MB)。 承诺数据为1.5 MB;已建数据块为865 kB. 运行 `bun run generate` 之后 凸起; 当承诺文件与新运行不同时, 包的测试失败 .

列表为MIT,版权为David Aerne (2017),其README要求简单归属. 列表混合来源 (维基百科,颜料制造,虚构) 并带有类似品牌的名称(Tiffany Blue, Ferrari Red; 它说它移除了 攻击性和受保护性的名字,有些人可能留下.

## 浏览器

十六进制色彩不需要任何东西: 没有运行时间, 没有 `@supports`,没有支持警告。 软件包的输出为每集一个声明 电话.

```bash
cd packages/color-names && bun run test        # the generated data, the engine (hex, errors), nearest()
cd packages/color-names && bun run typecheck   # and the type test, test/types/color-names.ts
cd packages/color-names && bun run generate    # src/<sector>.ts from the dependency
```

## 常见问题

### @cssints/color-names 是什么？

Cssints 的颜色名称列表: 以十六进制颜色命名\( “ tagerine ” \), 在 hue 扇区中, 完成时间不长

### 如何安装 @cssints/color-names？

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

### @cssints/color-names 支持 TypeScript 吗？

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

### @cssints/color-names 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cssints/color-names 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cssints/color-names 可以商用吗？

@cssints/color-names 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cssints/color-names 的下载量有多少？

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

### @cssints/color-names 还在维护吗？

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