Chalk for JavaScript (Node.js): 完整指南与示例

什么是 Chalk 以及为什么需要它？

\n\n

Chalk 是 Node.js 最流行的库之一，用于在终端（控制台）中美化输出样式。如果你曾经写过 console.log() 并希望文本带有颜色、加粗、下划线或闪烁效果——Chalk 可以优雅而简单地解决这个问题。

\n\n

为什么需要它？在实际项目中，彩色输出有助于：

\n

\n
• 视觉上区分日志（错误用红色，警告用黄色，成功用绿色）。
\n
• 改善 CLI 工具和脚本的用户体验。
\n
• 突出显示重要信息。
\n
• 使长日志更易读。
\n

\n\n

Chalk 没有依赖项，运行速度快，并支持链式调用。它会自动检测终端是否支持颜色，并在必要时禁用样式（例如，当输出重定向到文件时）。

\n\n

安装

\n\n

Chalk 通过 npm 分发。在你的项目中安装它：

\n\n

npm install chalk

\n\n

如果你使用 yarn：

\n\n

yarn add chalk

\n\n

安装后，在你的脚本中导入该库：

\n\n

const chalk = require('chalk');

\n\n

对于使用 ES 模块的项目（package.json 中 type: "module"），导入方式如下：

\n\n

import chalk from 'chalk';

\n\n

重要提示： 从 Chalk 5.0 版本开始，该库仅支持 ESM（仅限 ES 模块）。如果你使用 CommonJS（require），请安装 4.x 版本：

\n\n

npm install chalk@4.1.2

\n\n

快速入门

\n\n

试试第一个示例。创建一个文件 example.js 并写入：

\n\n

const chalk = require('chalk');\n\nconsole.log(chalk.blue('Hello, world!'));\nconsole.log(chalk.red.bold('错误！'));\nconsole.log(chalk.green.underline('成功'));\nconsole.log(chalk.yellow.bgBlue('蓝色背景上的黄色文字'));

\n\n

运行：

\n\n

node example.js

\n\n

你将看到彩色输出。如果颜色没有显示，请检查你的终端是否支持 ANSI 颜色（现代终端都支持）。

\n\n

主要方法和函数

\n\n

Chalk 提供两种 API：修饰符方法（文本样式）和 颜色方法（文本和背景颜色）。它们都可以通过链式调用组合使用。

\n\n

1. chalk.red() — 红色文本

\n

功能： 将文本染成红色。最常用于错误信息。

\n

参数： 接受一个字符串或多个字符串（用逗号分隔，会合并它们）。

\n

console.log(chalk.red('错误：文件未找到'));\nconsole.log(chalk.red('严重', '错误', '系统')); // 用空格合并

\n\n

2. chalk.green() — 绿色文本

\n

功能： 将文本染成绿色。用于成功信息。

\n

参数： 与 red 类似。

\n

console.log(chalk.green('操作成功完成'));\nconsole.log(chalk.green('✓', '完成'));

\n\n

3. chalk.blue() — 蓝色文本

\n

功能： 将文本染成蓝色。常用于信息性消息。

\n

参数： 一个字符串或多个字符串。

\n

console.log(chalk.blue('信息：版本 2.0.1'));

\n\n

4. chalk.yellow() — 黄色文本

\n

功能： 将文本染成黄色。传统上用于警告。

\n

参数： 一个字符串或多个字符串。

\n

console.log(chalk.yellow(