10分钟上手cli-color：从安装到高级样式的快速入门教程

【免费下载链接】cli-colorColors and formatting for the console项目地址: https://gitcode.com/gh_mirrors/cl/cli-color

cli-color是一款功能强大的控制台颜色和格式化工具，让开发者能够轻松为终端输出添加丰富的色彩、样式和特殊效果。无论是创建引人注目的日志信息、构建交互式命令行工具，还是美化脚本输出，cli-color都能提供简单直观的API来实现专业级的终端格式化效果。

快速安装cli-color的两种方法 🚀

使用npm一键安装（推荐）

在项目目录中打开终端，执行以下命令即可完成安装：

npm install cli-color

从源码仓库安装

如果需要最新开发版本，可以通过以下命令克隆仓库并手动安装：

git clone https://gitcode.com/gh_mirrors/cl/cli-color cd cli-color npm install

安装完成后，通过require语句即可在项目中使用：

var clc = require("cli-color");

基础颜色与样式使用指南 🌈

文本颜色基础用法

cli-color提供16种基础颜色（8种标准色+8种亮色），通过简单的方法调用即可应用：

// 基础文本颜色 console.log(clc.red("错误消息")); console.log(clc.green("成功消息")); console.log(clc.blue("信息提示")); // 亮色变体 console.log(clc.redBright("高亮错误")); console.log(clc.greenBright("高亮成功"));

背景颜色设置

通过bg+颜色名的方式可以设置文本背景色，支持所有基础颜色：

console.log(clc.bgRed.white("白色文本红色背景")); console.log(clc.bgBlue.yellowBright("亮黄色文本蓝色背景"));

文本样式组合应用

多种样式可以链式组合使用，创造丰富的视觉效果：

// 组合样式示例 console.log(clc.bold.underline.red("加粗下划线红色文本")); console.log(clc.italic.yellow.bgBlack("黑色背景斜体黄色文本"));

最佳实践是预先定义常用样式，提高代码可读性和维护性：

// 预定义样式 var error = clc.red.bold; var warn = clc.yellow; var notice = clc.blue.italic; // 使用预定义样式 console.log(error("致命错误：文件不存在")); console.log(warn("警告：内存使用率过高")); console.log(notice("提示：请更新到最新版本"));

高级功能与实用技巧 ⚡

终端光标控制与屏幕操作

cli-color提供了完整的光标移动和屏幕控制功能，适用于创建交互式终端应用：

// 光标移动 process.stdout.write(clc.move.up(2)); // 上移2行 process.stdout.write(clc.move.right(5)); // 右移5列 process.stdout.write(clc.move.to(0, 0)); // 移动到左上角 // 屏幕清除 process.stdout.write(clc.erase.screen); // 清屏 process.stdout.write(clc.erase.line); // 清除当前行

表格格式化输出

使用clc.columns可以轻松创建对齐的表格输出，支持自定义列对齐方式：

console.log(clc.columns([ [clc.bold("姓名"), clc.bold("年龄"), clc.bold("状态")], ["张三", "28", clc.green("在线")], ["李四", "32", clc.red("离线")], ["王五", "25", clc.yellow("忙碌")] ], { sep: " | " }));

加载动画效果

通过throbber模块可以创建简单的加载动画，提升用户体验：

var setupThrobber = require("cli-color/throbber"); // 创建并启动加载动画 var throbber = setupThrobber(str => process.stdout.write(str), 200); throbber.start(); // 模拟耗时操作 setTimeout(() => throbber.stop(), 3000);

256色高级应用

对于支持xterm颜色的终端，可以使用256色模式创建更丰富的色彩效果：

// 使用xterm颜色代码 console.log(clc.xterm(202).bgXterm(236)("橙色文本深色背景")); console.log(clc.xterm(46).bgXterm(124)("绿色文本红色背景"));

实用工具函数 🛠️

字符串处理工具

cli-color提供了几个实用的字符串处理函数，方便处理带格式的文本：

// 剥离ANSI格式 var ansiStrip = require("cli-color/strip"); var plainText = ansiStrip(clc.red("带格式的文本")); // 获取实际文本长度（忽略格式） var str = clc.bold("Hello") + clc.red("World"); console.log(clc.getStrippedLength(str)); // 输出: 10 // 带格式字符串切片 var sliced = clc.slice(str, 0, 5); // 保留格式的切片操作

终端窗口信息

获取终端窗口尺寸，用于自适应布局：

console.log("终端宽度: " + clc.windowSize.width); console.log("终端高度: " + clc.windowSize.height);

常见问题与注意事项 ❗

样式不显示问题

如果终端不显示颜色或样式，请检查：

1. 终端是否支持ANSI转义序列（大多数现代终端都支持）
2. 是否设置了NO_COLOR环境变量（会禁用所有颜色输出）
3. 确保样式代码正确，没有拼写错误

跨平台兼容性

• Windows系统下可能需要使用支持ANSI的终端（如Windows Terminal、VSCode终端）
• xterm 256色在部分老旧终端上可能无法正常显示，会自动降级为基础16色

性能考量

• 避免在高频输出场景（如每秒多次）使用过多复杂样式组合
• 对于大量文本输出，建议先构建完整字符串再一次性输出

示例代码与项目结构

cli-color项目包含多个示例文件，展示不同功能的使用方法：

• examples/basic.js - 基础颜色和样式演示
• examples/styles.js - 所有可用样式的展示
• examples/throbber.js - 加载动画示例
• examples/xterm.js - 256色使用示例

通过研究这些示例，可以快速掌握cli-color的各种功能和最佳实践。

总结

通过本教程，你已经了解了cli-color的安装方法、基础用法和高级功能。这款轻量级工具能帮助你轻松创建专业的终端输出效果，提升命令行工具的用户体验。无论是简单的日志着色还是复杂的交互式终端应用，cli-color都能提供直观而强大的API支持。

现在就开始在你的项目中使用cli-color，让终端输出从此告别单调！

【免费下载链接】cli-colorColors and formatting for the console项目地址: https://gitcode.com/gh_mirrors/cl/cli-color