如何解决Node.js readline触发IntelliJ IDEA终端刷屏、高CPU占用问题

核心原因 #

出现该问题的核心原因是IntelliJ IDEA 2021.1内置终端对Node.js readline模块的光标控制接口兼容度不足：当调用readline.cursorTo(process.stdout, 0)时，接口会发出对应的ANSI终端控制序列，原生Mac终端可以正常解析该序列实现“光标回到当前行开头”的重绘效果，但IDEA内置终端在默认配置下会将该控制序列作为普通文本追加到输出流，导致进度行逐次拼接成超长字符串，持续触发的输出操作最终拉满CPU占用，拖慢整体下载流程。

一、readline进度重绘在IDEA内置终端正常运行的调整方法 #

• 代码层做高兼容替换：放弃完全依赖readline的cursorTo接口，在输出进度前手动写入通用终端控制序列，替代原有光标定位逻辑，调整后的核心代码片段：

const puppeteer = require('puppeteer')
// 定义兼容全终端的清行回开头控制序列
const CLEAR_CURRENT_LINE = '\x1b[2K\r'

await puppeteer
  .createBrowserFetcher(/* 原有初始化配置参数 */)
  .download(puppeteer._preferredRevision, function (downloadBytes, totalBytes) {
    const percent = ((downloadBytes / totalBytes) * 100).toFixed(0)
    // 先发送清行控制序列，再写入进度内容
    process.stdout.write(`${CLEAR_CURRENT_LINE}Downloading browser ${percent.toString().padStart(5)}%`)
  })

这种写法不需要依赖readline实例的输出能力，对IDEA内置终端的兼容度远高于原生cursorTo调用，同时可在Mac原生终端保持原有重绘效果。

• 调整IDEA终端内置缓冲策略：打开IDEA设置面板，找到「工具 > 终端」配置页，取消勾选「按行缓冲控制台输出」选项，避免ANSI控制序列被缓冲区拆分、无法被终端正确解析。

二、不修改系统配置文件前提下调整IDEA内置终端TERM变量的方法 #

所有配置均可在IDEA自身设置中完成，不会修改~/.zshrc/~/.bash_profile等系统级配置，也不会影响原生Mac终端的默认TERM值，操作步骤为：

• 打开IDEA设置面板，Mac系统路径为IntelliJ IDEA > Settings > Tools > Terminal
• 找到「环境变量」配置栏，点击编辑按钮新增自定义环境变量：
  • 变量名：TERM
  • 变量值：xterm-256color
• 保存配置后重启内置终端，所有在终端内启动的进程（包括Node.js v15.2.1、npm 7.10.0运行的脚本）都会读取到自定义的TERM值，与Mac原生终端的运行环境完全一致。
• 补充临时方案：如果不想修改全局终端配置，也可以在npm脚本启动命令前临时注入TERM变量，仅对当前下载脚本生效，示例为在package.json中配置启动命令：

{
  "scripts": {
    "download-browser": "TERM=xterm-256color node ./scripts/download-browser.js"
  }
}

内容的提问来源于stack exchange，提问作者wh81752