1. 项目概述为什么我们需要一个现代的 ANSI 库如果你在 Deno 或 Node.js 里写过命令行工具肯定遇到过要给终端输出加点颜色、移动一下光标或者做个进度条的需求。这时候你大概率会去搜“如何在终端输出彩色文字”然后找到一堆教你拼接\x1b[31m这种神秘代码的帖子。刚开始可能觉得挺酷但项目稍微复杂点代码里到处都是这种“魔法字符串”不仅难读、难维护而且不同终端对 ANSI 转义序列的支持千差万别一不小心就出乱码或者根本没效果。这就是neabyte/deno-ansi要解决的问题。它不是一个简单的颜色库而是一个为 Deno 环境量身打造、功能全面的终端控制工具包。它把那些晦涩的\x1b[...序列封装成了直观的、类型安全的 TypeScript 方法让你能用Colors.red(Error!)这样的方式写代码。更重要的是它覆盖了从基础的颜色、样式到光标控制、终端模式设置、鼠标事件甚至是一些终端扩展如 iTerm2、Konsole的特有功能。对于需要构建复杂交互式 CLI命令行界面、终端仪表盘、游戏或者任何需要精细控制终端输出的开发者来说这个库能极大地提升开发效率和代码的可维护性。2. 核心设计思路模块化与类型安全看一个库好不好用先看它的设计。neabyte/deno-ansi采用了非常清晰的模块化设计将不同功能域划分到独立的类中。这不是随便分的而是遵循了 ANSI 标准本身和终端交互的逻辑层次。2.1 功能模块的清晰划分Colors (颜色与样式)这是最常用的部分。它没有把所有方法都堆在一个对象里而是进一步细分。基础 16 色、256 色、RGB 真彩色是分开的方法样式加粗、下划线等也是独立的。这样做的好处是类型提示非常友好你在写Colors.的时候IDE 会自动补全red,bgBlue,rgb等方法不会在一堆方法里迷失。特别是Colors.style(text, ...styles)方法允许你组合多个样式这在实现动态或条件样式时非常有用。Cursor (光标控制)所有与光标移动、位置查询、形状和可见性相关的操作都在这里。它区分了相对移动moveUp和绝对移动moveTo并且提供了位置保存与恢复save/restore的功能。这个设计考虑到了制作复杂动画或菜单时需要临时移动光标再返回原处的场景。Terminal (终端控制)这是功能最庞杂的模块负责终端本身的状态。它又细分为几个子类屏幕与行操作如clearScreen,clearLine。窗口标题与图标setWindowTitle。缓冲区管理enableAltBuffer/disableAltBuffer。这是做全屏应用的关键启用备用缓冲区后你的操作不会污染之前的命令行历史退出时能完美恢复。模式控制一大堆enableXXXMode/disableXXXMode。比如enableBracketedPaste可以让终端正确识别粘贴的文本避免粘贴内容被当作命令立即执行enableMouseTracking为鼠标交互打下基础。显示模式一组设置复古分辨率模式的方法如setMode80x25Color。虽然现在用得少但对于模拟复古终端或某些特定兼容性场景很有用。Input (输入处理)这是实现交互的核心。enableRawMode是关键它将标准输入stdin从默认的“行模式”按回车才提交切换到“原始模式”使得程序可以实时读取每一个按键包括方向键、功能键等。配合readKey方法你可以轻松构建键盘驱动的交互界面。Mouse (鼠标支持)提供了不同粒度的鼠标事件跟踪开启/关闭方法。注意鼠标事件需要终端支持并且通常需要配合Input模块来读取原始输入流并进行解析。Extensions (终端扩展)这是一个非常实用的模块它承认了终端世界的碎片化。iTerm2、Konsole、VTE、xterm 等主流终端模拟器都有自己私有的扩展序列。这个模块提供了统一的方式来调用这些功能比如在 iTerm2 中直接显示图片 (iTerm2DisplayImage)这是标准 ANSI 做不到的。其他工具类Control提供控制字符如响铃bellCharsets处理字符集现在较少使用Printer和VT100则处理更边缘的硬件或历史特性。这种模块化设计让代码的职责非常清晰。当你需要颜色时你知道去Colors里找需要处理按键时就去Input。而不是在一个拥有上百个方法的巨型对象里挣扎。2.2 同步与异步的明智选择仔细观察方法你会发现有些是同步的如Colors.red()有些是异步的如Cursor.moveTo()。这并非随意为之。同步方法通常只返回一个字符串。例如Colors.red(text)只是返回包裹了 ANSI 码的字符串不涉及任何 I/O 操作所以是同步的。你可以在任何地方拼接字符串最后一次性console.log。异步方法涉及到向终端写入控制序列并可能需要等待终端响应或确保写入顺序的操作。例如Cursor.moveTo(10, 5)它需要向标准输出stdout写入字节序列。在 Deno 中使用Deno.stdout.write是异步操作。为了保证一系列终端操作如清屏、移动光标、再输出文字能按顺序正确执行这些方法被设计为async你可以用await来串行执行。实操心得在编写 CLI 工具时我习惯将所有的终端输出操作包括颜色文本和光标控制封装在一个专门的output函数或类里内部统一使用await来调用这些异步方法。这样可以避免在业务逻辑中混杂大量的await让代码更清晰。例如一个renderProgressBar函数内部可能连续调用多个Terminal和Cursor的异步方法。3. 从安装到“Hello World”快速上手实战理论说了不少我们来点实际的。假设你已经安装了 Deno建议版本 1.30创建一个新项目。3.1 安装与导入根据官方推荐使用deno add命令来添加依赖。这个命令会更新你的deno.json文件。# 在你的项目根目录下执行 deno add jsr:neabyte/deno-ansi执行成功后你的deno.json文件里会多出一行依赖。之后你就可以在代码中直接导入了。创建一个名为app.ts的文件// 方式一按需导入特定类推荐Tree-shaking友好 import { Colors, Cursor, Terminal } from neabyte/deno-ansi; // 方式二导入整个命名空间如果用到很多类 import * as Ansi from neabyte/deno-ansi; // 使用方式Ansi.Colors.red(...)3.2 第一个彩色输出让我们写一个最简单的例子输出红色和粗体的“Hello World”。import { Colors } from neabyte/deno-ansi; console.log(Colors.red(Hello) Colors.bold(World)); // 或者使用模板字符串 console.log(${Colors.red(Hello)} ${Colors.bold(World)});运行它deno run app.ts。你应该能看到红色的 “Hello” 和粗体的 “World”。注意“World”只是粗体颜色是终端默认色通常白色。如果你想让它既是红色又是粗体有几种方法// 方法1嵌套调用 console.log(Colors.bold(Colors.red(Hello World))); // 方法2使用 style 方法组合 console.log(Colors.style(Hello World, Colors.red, Colors.bold)); // 方法3使用 fg 指定颜色适合动态颜色 console.log(Colors.bold(Colors.fg(Hello World, red)));注意事项ANSI 颜色在大多数现代终端上都能工作但并非所有环境都支持。例如某些 CI/CD 环境如 GitHub Actions 的默认日志查看器或重定向输出到文件时这些转义码会原样显示为乱码。好的做法是提供一个--no-color这样的命令行选项在检测到不支持彩色或用户明确要求时降级到无颜色的纯文本输出。这个库本身不处理这个需要你在应用层实现。3.3 实现一个简单的交互光标移动与清屏现在我们来点动态的。下面的代码会清屏把光标移动到第5行第10列然后输出一段带样式的文本。import { Colors, Cursor, Terminal } from neabyte/deno-ansi; async function main() { // 1. 清屏创造一个干净的画面 await Terminal.clearScreen(); // 2. 将光标移动到指定位置行列。注意终端坐标通常从 (1,1) 开始。 await Cursor.moveTo(10, 5); // 第5行第10列 // 3. 在该位置输出带样式的文字 console.log(Colors.bgBlue(Colors.white( 光标定位在这里 ))); // 4. 将光标移动到屏幕底部避免后续输出覆盖我们的“作品” const terminalSize await Terminal.getSize(); await Cursor.moveTo(1, terminalSize.rows); console.log(程序结束。); } // 运行主函数 if (import.meta.main) { main().catch(console.error); }运行这个程序你会看到屏幕被清空然后在指定位置出现一个蓝底白字的方块。Terminal.getSize()是一个非常有用的方法它返回终端的列数和行数让你能实现响应式布局。4. 构建交互式 CLI输入处理与状态管理真正的命令行工具离不开交互。我们结合Input和Cursor模块做一个经典的“按任意键继续”的例子并扩展成一个简单的选择菜单。4.1 基础输入与原始模式import { Input, Terminal } from neabyte/deno-ansi; async function waitForAnyKeyDemo() { console.log(演示即将开始...); await Input.waitForAnyKey(); // 程序会在此暂停直到用户按下任意键 console.log(你按了一个键); // 更精细的控制读取具体的键 console.log(请按方向键上或下 (按 q 退出)...); while (true) { const key await Input.readKey(); // 读取并解析一个按键 console.log(你按下了: ${key.name} (代码: ${key.code})); if (key.name q || key.code q) { console.log(退出。); break; } if (key.name up) { console.log(↑ 上箭头被按下); // 这里可以更新选择状态 } else if (key.name down) { console.log(↓ 下箭头被按下); // 这里可以更新选择状态 } } } if (import.meta.main) { waitForAnyKeyDemo().catch(console.error); }Input.readKey()的强大之处在于它帮你解析了复杂的转义序列。当你按下“上箭头”终端实际发送的是\x1b[A这样的字节序列。readKey()将其解析为一个易用的对象如{ name: up, code: \x1b[A, ... }省去了自己解析的麻烦。4.2 实现一个简单的文本菜单下面我们实现一个更完整的例子一个在终端中高亮显示当前选项的菜单。import { Colors, Cursor, Input, Terminal } from neabyte/deno-ansi; interface MenuItem { text: string; action: () Promisevoid | void; } class SimpleMenu { private items: MenuItem[]; private selectedIndex: number 0; private isRunning: boolean true; constructor(items: MenuItem[]) { this.items items; } private async render() { // 保存光标位置以便在原地重绘菜单 await Cursor.save(); await Cursor.moveTo(1, 1); // 假设我们在屏幕顶部绘制 for (let i 0; i this.items.length; i) { const item this.items[i]; await Terminal.clearLine(); // 清除当前行 if (i this.selectedIndex) { // 选中项绿色背景白色粗体字 console.log(Colors.bgGreen(Colors.bold(Colors.white( ❯ ${item.text} )))); } else { // 未选中项默认样式 console.log( ${item.text}); } } await Cursor.restore(); // 恢复光标到保存的位置行首准备接收下一个输入 } async run() { // 启用原始模式以便捕获单个按键 Input.enableRawMode(); // 隐藏光标让界面更干净 await Cursor.setCursorVisible(false); await this.render(); while (this.isRunning) { const key await Input.readKey(); switch (key.name) { case up: this.selectedIndex (this.selectedIndex - 1 this.items.length) % this.items.length; await this.render(); break; case down: this.selectedIndex (this.selectedIndex 1) % this.items.length; await this.render(); break; case enter: case return: await this.items[this.selectedIndex].action(); // 执行动作后可以重新渲染菜单或退出 // 这里我们选择退出循环 this.isRunning false; break; case q: case escape: this.isRunning false; break; } } // 退出前恢复终端状态 await Cursor.setCursorVisible(true); Input.disableRawMode(); await Terminal.clearScreen(); console.log(菜单已退出。); } } async function main() { const menu new SimpleMenu([ { text: 启动服务, action: () console.log(\n执行: 启动服务...), }, { text: 停止服务, action: () console.log(\n执行: 停止服务...), }, { text: 查看日志, action: () console.log(\n执行: 查看日志...), }, { text: 退出程序, action: () console.log(\n执行: 退出...), }, ]); await menu.run(); } if (import.meta.main) { main().catch(console.error); }这个例子展示了几个关键点状态驱动渲染selectedIndex是状态每次按键改变状态后调用render()重绘整个菜单。光标控制使用Cursor.save()和Cursor.restore()来确保每次重绘都在同一位置避免菜单“跳动”。原始模式Input.enableRawMode()是必须的否则readKey()无法即时捕获按键。资源清理在退出前一定要恢复光标可见性和禁用原始模式这是一个好习惯避免把终端留在奇怪的状态。踩坑记录在开发这类交互程序时如果程序异常崩溃终端可能会停留在原始模式导致输入不回显。这时候可以尝试按CtrlC中断或者输入reset命令并回车来强制重置终端。更好的做法是在你的程序顶层用try...catch...finally确保disableRawMode和showCursor总能被执行。5. 高级特性深潜备用缓冲区与鼠标交互对于需要全屏或复杂界面更新的应用比如终端文件管理器ranger、系统监控工具htop直接在当前屏幕操作会留下历史输出体验很差。这时就需要用到备用缓冲区。5.1 备用缓冲区Alternate Buffer的使用import { Colors, Cursor, Input, Terminal } from neabyte/deno-ansi; async function alternateBufferDemo() { console.log(这是主缓冲区。3秒后进入备用缓冲区...); await new Promise(resolve setTimeout(resolve, 3000)); // 切换到备用缓冲区全屏应用开始 await Terminal.enableAltBuffer(); await Terminal.clearScreen(); await Cursor.moveTo(20, 10); console.log(Colors.cyan.bold(欢迎来到全屏模式)); await Cursor.moveTo(20, 12); console.log(你可以在这里进行任何操作而不会影响主缓冲区的历史。); await Cursor.moveTo(20, 14); console.log(按任意键返回...); await Input.waitForAnyKey(); // 切换回主缓冲区全屏应用结束 await Terminal.disableAltBuffer(); console.log(\n已回到主缓冲区。你看之前的输出还在上面。); } if (import.meta.main) { alternateBufferDemo().catch(console.error); }启用备用缓冲区后你就像获得了一块全新的画布。所有的清屏、光标移动、输出都只在这块画布上进行。当你禁用备用缓冲区时终端会瞬间切回原来的主缓冲区之前的所有命令行历史都完好无损。这是构建专业 CLI 工具的必备技能。5.2 鼠标事件处理鼠标支持能让你的工具更加易用。但请注意鼠标跟踪需要终端支持大多数现代终端模拟器都支持。import { Colors, Cursor, Input, Mouse, Terminal } from neabyte/deno-ansi; async function mouseTrackingDemo() { await Terminal.enableAltBuffer(); await Terminal.clearScreen(); Input.enableRawMode(); // 启用所有鼠标跟踪模式基本点击、拖动、移动 await Mouse.enableAllTracking(); console.log(Colors.yellow.bold(鼠标跟踪演示)); console.log(点击或移动鼠标。按 q 退出。); await Cursor.moveTo(1, 5); let running true; while (running) { const key await Input.readKey(); if (key.code q) { running false; break; } // 尝试解析鼠标事件 const mouseEvent Mouse.parseMouseEvent(key.code) || Mouse.parseSGREvent(key.code); if (mouseEvent) { await Terminal.clearLine(); // 清除上一行信息 console.log(鼠标事件: 按钮${mouseEvent.button}, X${mouseEvent.x}, Y${mouseEvent.y}, 动作${mouseEvent.action}); // 可以根据事件在对应位置绘制一些反馈比如一个“X” await Cursor.save(); await Cursor.moveTo(mouseEvent.x, mouseEvent.y); console.log(Colors.red(X)); await Cursor.restore(); } } // 清理 await Mouse.disableAllTracking(); Input.disableRawMode(); await Terminal.disableAltBuffer(); console.log(演示结束。); } if (import.meta.main) { mouseTrackingDemo().catch(console.error); }这个例子开启了鼠标跟踪并在循环中尝试解析输入是否为鼠标事件。parseMouseEvent和parseSGREvent分别对应两种不同的鼠标报告协议。当你在终端窗口内点击或移动时程序会输出事件详情并在点击位置画一个红色的 “X”。这为开发终端图形界面或游戏提供了可能。6. 性能优化与最佳实践当你的 CLI 工具需要频繁更新界面如实时进度条、监控仪表盘时性能就变得很重要。频繁的清屏和重绘会导致闪烁。6.1 减少闪烁局部更新与双缓冲思想全屏清屏 (Terminal.clearScreen()) 是最耗时的操作。应优先使用更精细的控制async function updateProgressBar(current: number, total: number) { const width 50; const percent (current / total) * 100; const filledWidth Math.round((width * current) / total); const bar █.repeat(filledWidth) ░.repeat(width - filledWidth); // 不好的做法每次清屏重绘整个界面 // await Terminal.clearScreen(); // ... 重绘所有内容 // 好的做法只更新进度条所在的行 await Cursor.save(); // 记住光标位置 await Cursor.moveTo(1, 3); // 移动到进度条行 await Terminal.clearLine(); // 只清除这一行 console.log([${bar}] ${percent.toFixed(1)}%); await Cursor.restore(); // 回到原来的位置不影响其他输出 }更进一步对于极其复杂的界面可以借鉴“双缓冲”思想先在内存中构建好完整的输出字符串然后一次性写入终端。async function renderComplexDashboard(data: any) { let output ; // 在内存中拼接所有 ANSI 序列和内容 output Cursor.moveTo(1, 1); output Terminal.clearLine(); output Colors.bold(仪表盘\n); output Cursor.moveTo(1, 3); output CPU: ${Colors.green(data.cpuUsage)}%\n; output Cursor.moveTo(1, 4); output 内存: ${Colors.blue(data.memUsage)}%\n; // ... 拼接更多行 // 一次性写入减少终端 I/O 次数 await Terminal.write(output); }Terminal.write方法允许你直接写入原始的 ANSI 序列字符串配合Cursor.moveTo等返回字符串的方法可以实现高效的批量更新。6.2 终端兼容性检测与优雅降级不是所有终端都支持 256 色、RGB 真彩色或鼠标。一个健壮的工具应该能检测并优雅降级。import { Colors, Extensions } from neabyte/deno-ansi; function getBestColorSupport(text: string, color: string) { // 这是一个简化的检测逻辑。实际中可以通过环境变量 TERM 或 // 使用更复杂的库如 supports-color来检测。 const term Deno.env.get(TERM) || ; if (term.includes(truecolor) || term.includes(24bit)) { // 假设支持真彩色 return Colors.rgb(text, 255, 100, 100); // 使用 RGB } else if (term.includes(256color)) { // 支持 256 色 return Colors.color256(text, 196); // 使用 256 色索引 } else { // 仅支持基础 16 色 return Colors.red(text); // 使用基础红色 } } // 检测终端扩展功能 const extension Extensions.detectTerminalExtension(); if (extension iterm2) { // 可以使用 iTerm2 独有的特性如图片显示 console.log(检测到 iTerm2可以使用高级特性。); } else { console.log(当前终端不支持特殊扩展使用标准 ANSI 功能。); }7. 常见问题排查与调试技巧即使有了这么好的库在实际开发中还是会遇到各种奇怪的问题。这里记录一些我踩过的坑和解决方法。7.1 问题颜色/样式不显示或显示为乱码原因1输出被重定向。当你运行deno run app.ts output.txt时ANSI 序列被直接写入文件在文本编辑器里看就是乱码。解决检测Deno.stdout.isTerminal()。如果是false则禁用所有颜色输出。import { Colors } from neabyte/deno-ansi; const isTTY Deno.stdout.isTerminal(); const red (text: string) isTTY ? Colors.red(text) : text; console.log(red(重要信息));原因2终端不支持。某些老旧或极简的终端可能不支持部分 ANSI 特性。解决提供--no-color命令行标志或通过环境变量NO_COLOR遵循 https://no-color.org/ 让用户手动禁用颜色。原因3样式未重置。如果你设置了背景色但没重置后续所有输出都会带背景色。解决在输出完带样式的文本后手动添加一个Colors.reset()或确保你的输出逻辑在每次行末都重置样式。更好的做法是将样式严格限制在需要它的文本块上而不是改变终端全局状态。7.2 问题光标位置错乱或界面闪烁原因1异步操作未等待。如果多个Cursor.moveTo或Terminal.clearLine操作没有用await串行化它们可能以错误的顺序到达终端。解决确保所有来自neabyte/deno-ansi的异步方法调用都使用了await。如果在一个循环中使用for...of而非forEach因为后者内部的回调函数处理async/await比较麻烦。原因2未使用备用缓冲区。在频繁更新的界面中如果用户滚动屏幕你的输出会变得混乱。解决对于全屏或复杂交互应用始终使用Terminal.enableAltBuffer()和Terminal.disableAltBuffer()来隔离你的应用界面。原因3程序崩溃未恢复终端状态。如果程序因异常退出而原始模式未禁用或光标被隐藏终端会行为异常。解决使用try...finally块来确保清理代码总能执行。Input.enableRawMode(); await Cursor.setCursorVisible(false); try { // ... 你的主逻辑 } catch (error) { console.error(发生错误:, error); } finally { // 无论如何都执行恢复操作 await Cursor.setCursorVisible(true); Input.disableRawMode(); if (inAlternateBuffer) { await Terminal.disableAltBuffer(); } }7.3 问题输入无响应或行为异常原因1未启用原始模式。这是最常见的原因。默认的“行模式”会缓冲输入直到按下回车。解决在需要读取单个按键前务必调用Input.enableRawMode()。原因2信号处理冲突。在原始模式下CtrlC(SIGINT) 等信号的行为可能改变。解决你需要自己监听并处理这些信号。Deno.addSignalListener(SIGINT, () { console.log(\n收到中断信号正在清理...); // 执行恢复操作... Deno.exit(0); });原因3终端类型不匹配。某些特殊的终端环境如 Docker 容器内、某些 IDE 的集成终端对 ANSI 序列的支持可能不完整。解决在开发初期尽量在主流终端如 iTerm2, GNOME Terminal, Windows Terminal中测试。如果必须支持特殊环境做好功能降级和测试。7.4 调试技巧看到底发了什么有时候你需要知道库到底向终端发送了什么序列特别是当效果不符合预期时。import { Cursor } from neabyte/deno-ansi; // Cursor.moveTo 返回的是字符串序列我们可以打印出来看 const moveSequence Cursor.moveTo(5, 10); console.log(转义序列:, JSON.stringify(moveSequence)); // 输出: \u001b[10;5H // 或者创建一个包装函数来记录所有输出 const originalStdoutWrite Deno.stdout.write; Deno.stdout.write async (data: Uint8Array): Promisenumber { console.error([DEBUG STDOUT]:, new TextDecoder().decode(data)); return await originalStdoutWrite(data); }; // 现在运行你的程序所有写入 stdout 的字节都会被打印到 stderr通过这种方式你可以确认发送的序列是否正确这是排查终端兼容性问题的最有效手段之一。8. 实战构建一个终端进度条组件最后我们综合运用所学构建一个可复用的、美观的进度条组件。这个组件支持颜色、自定义宽度、动态文本并且更新时不会引起闪烁。import { Colors, Cursor, Terminal } from neabyte/deno-ansi; interface ProgressBarOptions { width?: number; // 进度条宽度字符 filledChar?: string; // 已完成部分字符 emptyChar?: string; // 未完成部分字符 showPercentage?: boolean; // 是否显示百分比 showValue?: boolean; // 是否显示当前值/总值 color?: (text: string) string; // 颜色函数 } class ProgressBar { private width: number; private filledChar: string; private emptyChar: string; private showPercentage: boolean; private showValue: boolean; private colorFn: (text: string) string; private lastOutputLength: number 0; constructor(options: ProgressBarOptions {}) { this.width options.width || 40; this.filledChar options.filledChar || █; this.emptyChar options.emptyChar || ░; this.showPercentage options.showPercentage ?? true; this.showValue options.showValue ?? true; this.colorFn options.color || ((t) t); // 默认无色 } async render(current: number, total: number, prefix: string , suffix: string ) { // 计算进度和需要渲染的字符串 const percent total 0 ? (current / total) : 0; const filledWidth Math.floor(this.width * percent); const emptyWidth this.width - filledWidth; const filledBar this.filledChar.repeat(filledWidth); const emptyBar this.emptyChar.repeat(emptyWidth); let bar [${filledBar}${emptyBar}]; // 添加文本信息 let info ; if (this.showPercentage) { info ${(percent * 100).toFixed(1).padStart(5)}%; } if (this.showValue) { info (${current}/${total}); } const fullText prefix this.colorFn(bar) info suffix; // 关键计算本次输出长度用于清除上一次可能更长的输出 const currentOutputLength fullText.length; const clearLength Math.max(this.lastOutputLength, currentOutputLength); // 移动到行首清除足够长度再输出新内容 await Cursor.moveToColumn(1); await Terminal.clearLineToEnd(); // 清除从光标到行尾简单有效 // 或者更精确的控制await Terminal.write( .repeat(clearLength)); await Cursor.moveToColumn(1); console.log(fullText); this.lastOutputLength currentOutputLength; } // 一个便捷的完成方法 async complete(message: string 完成) { await this.render(1, 1); // 渲染到100% console.log( ${Colors.green(✓)} ${message}); } } // 使用示例 async function demo() { const total 100; const bar new ProgressBar({ width: 50, color: Colors.cyan, filledChar: , emptyChar: -, }); console.log(开始下载...\n); for (let i 0; i total; i 5) { await bar.render(i, total, 下载: ); // 模拟耗时操作 await new Promise(resolve setTimeout(resolve, 100)); } await bar.complete(下载完成。); } if (import.meta.main) { demo().catch(console.error); }这个ProgressBar类封装了进度条的核心逻辑根据进度计算填充长度、组装显示文本、以及最重要的——通过Cursor.moveToColumn(1)和Terminal.clearLineToEnd()实现原地更新避免了换行和闪烁。你可以轻松地把它集成到任何需要显示进度的 CLI 工具中。neabyte/deno-ansi这个库将终端编程从“黑魔法”变成了“工程实践”。它通过清晰的 API 设计覆盖了终端交互的绝大多数需求。从我自己的使用经验来看最大的价值在于它让代码的可读性和可维护性大幅提升。你再也不需要去记忆\x1b[2J是清屏还是\x1b[?25l是隐藏光标只需要调用语义清晰的方法。在开发复杂的 Deno CLI 应用时它应该成为你的首选工具之一。