在 TypeScript(Deno、Bun、Node)中使用 ANSI 转义码
TypeScript 本身会被转译 —— 实际写入终端的字节与 JavaScript 一致。三种 TS 运行时的差异在于标准库的写入调用:Node 用 process.stdout.write,Deno 用 Deno.stdout.writeSync(或 console.log),Bun 同时支持 Node 的 process.stdout shim 与自身的 Bun.write(Bun.stdout, …)。三者都按字节透传。带类型的便利 API 可选 picocolors(零依赖,通过 npm: / jsr: / 直接 import 在每个运行时中可用)、Deno 自带的 @std/fmt/colors,或更小巧、同构的 kolorist。chalk 5+ 仅支持 ESM,可在 Node / Bun / Deno(npm:chalk)下使用。
推荐库
- picocolors
零依赖、约 100 行、完整类型。冷启动最快,也是三个运行时唯一可以用同一种方式导入的库(Deno 用
npm:picocolors,Node / Bun 直接import)。 - chalk
经典的可链式 API(
chalk.bold.red('oops')),具备完整 TypeScript 类型,自动检测 16 / 256 / 16M 色支持。v5+ 为纯 ESM —— 兼容 Node 14.16+、Bun,以及通过npm:chalk的 Deno。 - @std/fmt/colors (Deno)
Deno 自带的彩色辅助函数 ——
red()、bold()、bgBlue()—— 无需安装、无依赖。纯 Deno 脚本中使用;跨运行时代码请用 picocolors / kolorist,使同一份文件能在各运行时执行。 - kolorist
极小的同构彩色辅助库 —— 可在 Node / Bun / Deno 以及浏览器中工作(在 DevTools 中自动回退到 CSS
%c样式)。Vite、marko、preact 都在使用。端到端类型完整。
常用写法
// Picks the stdout API of whichever runtime is executing. All three are
// byte-clean — \x1b sequences pass through unchanged.
const RED_BOLD = '\x1b[1;31m';
const RESET = '\x1b[0m';
const line = `${RED_BOLD}error:${RESET} permission denied\n`;
declare const Deno: { stdout: { writeSync(b: Uint8Array): number } } | undefined;
declare const Bun: { stdout: unknown; write(d: unknown, s: string): Promise<number> } | undefined;
if (typeof Deno !== 'undefined') {
Deno.stdout.writeSync(new TextEncoder().encode(line));
} else if (typeof Bun !== 'undefined') {
await Bun.write(Bun.stdout, line);
} else {
process.stdout.write(line);
}// Compile-time check that you only pass known SGR codes — typos fail tsc.
type SGR =
| 0 | 1 | 2 | 3 | 4 | 7 | 22 | 23 | 24 | 27
| 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 39
| 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97;
const sgr = (text: string, ...codes: SGR[]): string =>
`\x1b[${codes.join(';')}m${text}\x1b[0m`;
console.log(sgr('error:', 1, 31), 'permission denied');
console.log(sgr('ok', 32));// deno run --allow-env script.ts
import { bold, red, rgb24 } from 'jsr:@std/fmt/colors';
console.log(`${bold(red('error:'))} permission denied`);
console.log(rgb24('lavender truecolor', 0xcba6f7));// Works under Node, Bun, and Deno — each exposes env vars differently.
declare const Deno: { env: { get(k: string): string | undefined }; stdout: { isTerminal(): boolean } } | undefined;
const env = (k: string): string | undefined =>
typeof Deno !== 'undefined' ? Deno.env.get(k) : process.env[k];
const isTTY = (): boolean =>
typeof Deno !== 'undefined' ? Deno.stdout.isTerminal() : Boolean(process.stdout.isTTY);
const USE_COLOR = isTTY() && env('NO_COLOR') === undefined && env('FORCE_COLOR') !== '0';
export const paint = (text: string, sgr: string): string =>
USE_COLOR ? `\x1b[${sgr}m${text}\x1b[0m` : text;