# @dabh/colors 中文文档

规范地址：https://npmcn.com/package/%40dabh/colors/

版本：1\.4\.0
npm 元数据更新时间：2022-04-05T02:31:57.456Z
中文译文更新时间：2026-11-11T08:17:19.651Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40dabh/colors
原文对照：https://npmcn.com/package/%40dabh/colors/?lang=original
项目主页：https://github.com/DABH/colors.js
源码仓库：https://github.com/DABH/colors.js

弃用说明：@dabh/colors has been renamed to @colors/colors\. Please update your package\.json\.

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

- 包体积（解压后）：39.5 kB，21 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=0\.1\.90
- 运行依赖：0 个
- 首次发布：2022-01-09T01:45:53.158Z
- 最新版本发布：2022-01-09T01:45:53.380Z
- 近 30 天下载量：252179（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

在节点.js控制台中获得颜色

## 安装

```sh
npm install @dabh/colors
```

也可以使用：`pnpm add @dabh/colors`、`yarn add @dabh/colors`、`bun add @dabh/colors`

## README

# 颜色.js

[![Build Status](https://travis-ci.org/Marak/colors.js.svg?branch=master)](https://travis-ci.org/Marak/colors.js) [![version](https://img.shields.io/npm/v/colors.svg)](https://www.npmjs.org/package/colors) [![dependencies](https://david-dm.org/Marak/colors.js.svg)](https://david-dm.org/Marak/colors.js) [![devDependencies](https://david-dm.org/Marak/colors.js/dev-status.svg)](https://david-dm.org/Marak/colors.js#info=devDependencies)

请检查一下 [路线图](https://npmcn.com/package/%40dabh/colors/ROADMAP.md) 为即将到来的特性和发布。 请打开问题以提供反馈,并检查 `develop` 用于最新的血源更新的分支.

## 在节点.js控制台中获得颜色和样式

![Demo](https://raw.githubusercontent.com/Marak/colors.js/master/screenshots/colors.png)

## 安装

```
npm install colors
```

## 颜色和风格!

### 文本颜色

-   黑色
-   红色
-   绿色
-   黄色
-   蓝色
-   红色
-   青红
-   白色
-   灰色
-   灰色

### 亮文本颜色

-   亮红色
-   亮绿色
-   亮黄色
-   亮蓝色
-   亮红色
-   闪亮的青色
-   发光白

### 背景颜色

-   bg 布莱克
-   bg红
-   bg 绿色
-   bg黄色
-   bg 蓝色
-   bg 红色
-   bg 青色线
-   bg 白调
-   bgGray (英语)
-   bg格雷语

### 亮背景颜色

-   bg 亮红色
-   bg 淡绿色
-   bg 亮黄色
-   bg 淡蓝色
-   bg Bright 红外线
-   bg 闪亮青色
-   bg 右白线

### 样式

-   重设
-   粗体
-   阴暗
-   斜体
-   下划线
-   反转
-   隐藏
-   击穿

### 额外

-   彩虹
-   斑马
-   美国
-   陷阱
-   随机

## 使用量

根据大众的要求, `colors` 现在船有两种用途!

超级美妙的方式

```js
var colors = require('colors');

console.log('hello'.green); // outputs green text
console.log('i like cake and pies'.underline.red); // outputs red underlined text
console.log('inverse the color'.inverse); // inverses the color
console.log('OMG Rainbows!'.rainbow); // rainbow
console.log('Run the trap'.trap); // Drops the bass

```

或稍微小一点的不延伸的方式 `String.prototype`

```js
var colors = require('colors/safe');

console.log(colors.green('hello')); // outputs green text
console.log(colors.red.underline('i like cake and pies')); // outputs red underlined text
console.log(colors.inverse('inverse the color')); // inverses the color
console.log(colors.rainbow('OMG Rainbows!')); // rainbow
console.log(colors.trap('Run the trap')); // Drops the bass

```

我更喜欢第一种方式。 有些人似乎害怕扩展 `String.prototype` 更喜欢第二种方式.

如果你写好的代码 你永远不会有 与第一个方法的问题。 如果你真的不想碰的话 `String.prototype`,第二个用法不会触碰 `String` 原生对象.

## 启用/ 禁用颜色

软件包将自动检测您的终端是否可以使用颜色并相应启用/失效 。 当颜色被禁用时,颜色函数无所作为. 您可以使用命令行旗来覆盖它 :

```bash
node myapp.js --no-color
node myapp.js --color=false

node myapp.js --color
node myapp.js --color=true
node myapp.js --color=always

FORCE_COLOR=1 node myapp.js
```

或用代码 :

```javascript
var colors = require('colors');
colors.enable();
colors.disable();
```

## 控制台.log [字符串替换](http://nodejs.org/docs/latest/api/console.html#console_console_log_data)

```js
var name = 'Marak';
console.log(colors.green('Hello %s'), name);
// outputs -> 'Hello Marak'
```

## 自定义主题

### 使用标准 API

```js

var colors = require('colors');

colors.setTheme({
  silly: 'rainbow',
  input: 'grey',
  verbose: 'cyan',
  prompt: 'grey',
  info: 'green',
  data: 'grey',
  help: 'cyan',
  warn: 'yellow',
  debug: 'blue',
  error: 'red'
});

// outputs red text
console.log("this is an error".error);

// outputs yellow text
console.log("this is a warning".warn);
```

### 使用字符串安全 API

```js
var colors = require('colors/safe');

// set single property
var error = colors.red;
error('this is red');

// set theme
colors.setTheme({
  silly: 'rainbow',
  input: 'grey',
  verbose: 'cyan',
  prompt: 'grey',
  info: 'green',
  data: 'grey',
  help: 'cyan',
  warn: 'yellow',
  debug: 'blue',
  error: 'red'
});

// outputs red text
console.log(colors.error("this is an error"));

// outputs yellow text
console.log(colors.warn("this is a warning"));

```

### 组合颜色

```javascript
var colors = require('colors');

colors.setTheme({
  custom: ['red', 'underline']
});

console.log('test'.custom);
```

_Protip : (英语) 里面有个秘密的无证风格 `colors`如果你找到那种风格 你可以召唤他._

## 常见问题

### @dabh/colors 是什么？

在节点\.js控制台中获得颜色注意：该包已被作者标记为弃用——@dabh/colors has been renamed to @colors/colors\. Please update your package\.json\.

### 如何安装 @dabh/colors？

在项目目录运行 npm install @dabh/colors，或使用 pnpm add / yarn add / bun add。

### @dabh/colors 支持 TypeScript 吗？

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

### @dabh/colors 支持 ESM 还是 CommonJS？

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

### @dabh/colors 需要什么版本的 Node\.js？

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

### @dabh/colors 可以商用吗？

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

### @dabh/colors 的下载量有多少？

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

### @dabh/colors 还在维护吗？

最新版本 1\.4\.0 发布于 2022/01/09（4 年前）；至今共发布 1 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/01/09。作者已将其标记为弃用，新项目建议寻找替代方案。