如何在自定义Node.js CLI中添加类似less/more的分页及文本高亮？

AI 小北

2026-8-10

Node.js CLI 实现带高亮的分页功能

问题本质

直接将stdout管道到less时，默认less会把ANSI颜色转义序列当作普通文本处理，导致原本的高亮效果丢失——这就是和git log的区别，git是主动调用了支持颜色解析的less实例。

解决方法

1. 让`less`识别ANSI颜色

启动less时必须添加-R参数，该参数会告诉less渲染ANSI转义序列，而非忽略或显示原始字符。

2. 在Node.js中集成`less -R`

通过child_process模块主动启动less -R子进程，将带高亮的输出写入其stdin，而非直接输出到stdout。示例代码：

const { spawn } = require('child_process');

// 启动支持颜色的less进程
const lessProcess = spawn('less', ['-R']);

// 生成带ANSI高亮的内容（这里用chalk举例，也可以用其他高亮库）
const chalk = require('chalk');
const output = `${chalk.red('ERROR')}: 配置文件不存在\n${chalk.green('INFO')}: 已加载默认配置`;

// 将内容写入less的输入流
lessProcess.stdin.write(output);
lessProcess.stdin.end();

// 绑定less的输出到当前进程的终端
lessProcess.stdout.pipe(process.stdout);
lessProcess.stderr.pipe(process.stderr);

// 监听less退出，同步终止当前进程
lessProcess.on('exit', (code) => process.exit(code));

3. 生成高亮文本的工具

不需要手动拼接ANSI序列，用成熟的库简化开发：

chalk：快速生成带颜色、加粗、下划线等样式的文本
cli-highlight：针对代码片段的语法高亮，支持多种编程语言

额外优化

检测终端是否支持颜色，避免在非终端环境（如管道到文件）输出无效的ANSI序列：

const supportsColor = require('supports-color');
const shouldUseColor = supportsColor.stdout?.level >= 1;

// 根据是否支持颜色生成对应内容
const output = shouldUseColor 
  ? `${chalk.red('ERROR')}: 错误信息` 
  : 'ERROR: 错误信息';