console.log 本身不支持颜色,需依赖 ANSI 转义序列;仅 Node.js 终端(如 VSCode Terminal)原生解析,Debug Console 和浏览器不支持,chalk 等库仅适用于 Node 环境。

console.log 本身不支持颜色,得靠 ANSI 转义序列
浏览器控制台原生不解析 \x1b[32m 这类 ANSI 颜色码,但 Node.js 的 console.log 在终端里能识别——VSCode 内置终端(Terminal)正是基于此机制。所以「控制台有颜色」的前提是:日志必须输出到 VSCode 的 Terminal(比如你用 node script.js 运行),而不是调试器的 Debug Console 或浏览器 DevTools。
常见错误现象:Debug Console 里看到一堆 \u001b[36mhello\u001b[0m 原样字符串,没变色;或者用了 chalk 却在浏览器环境报错 Cannot find module 'fs'。
- 只对 Node.js 环境有效,前端项目无效(除非用 webpack 插件或自定义 dev server 中间件劫持 console)
- VSCode 设置里要确保
terminal.integrated.env.*没禁用TERM(默认没问题) - Windows 用户注意:旧版 CMD 不支持 ANSI,但 VSCode 终端默认启用虚拟终端模式(Windows 10 18362+),无需额外配置
用 chalk 最省事,但要注意版本和导入方式
chalk 是封装 ANSI 的最常用库,v4+ 默认是 ESM,require('chalk') 会报错 ERR_REQUIRE_ESM。必须按模块方式导入,且不能混用 import 和 require。
使用场景:日常脚本、CLI 工具、Node 启动日志、单元测试输出增强可读性。
- v4+ 正确写法:
import chalk from 'chalk';或const chalk = await import('chalk'); - v3 仍可用
const chalk = require('chalk');,但已不维护,缺少 truecolor 支持 - 避免全局污染:别写
chalk.enabled = true,VSCode 终端自动检测支持度 - 性能影响极小,但高频日志(如每毫秒打一条)建议缓存样式实例:
const info = chalk.blue.bold
import chalk from 'chalk';
console.log(chalk.red('ERROR:'), chalk.yellow('file not found'));
console.log(chalk.green('✓'), chalk.cyan('Loaded config'));
不用第三方库?手写 ANSI 代码也够用
如果项目禁止引入依赖,直接拼接 ANSI 序列完全可行。关键不是记全所有码,而是掌握几组最常用、兼容性最好的:
-
\x1b[32m绿色(成功)、\x1b[33m黄色(警告)、\x1b[31m红色(错误)——几乎所有终端都支持 - 重置必须加
\x1b[0m,否则后续所有输出都会带颜色 - 不要用
\e或\033,统一用\x1b(十六进制表示更可靠) - Node.js 16.14+ 支持
process.stdout.hasColors()判断是否该输出颜色,避免日志被 CI 截断时出现乱码
const red = '\x1b[31m';
const reset = '\x1b[0m';
console.log(`${red}Failed to connect${reset} — retrying...`);
调试时想在 Debug Console 看颜色?不行,换思路
VSCode 的 Debug Console 是基于 Chrome DevTools 协议的,它把 console.log 当纯文本渲染,ANSI 序列会被当普通字符显示。这是设计限制,不是配置问题。
容易踩的坑:launch.json 里加 "console": "integratedTerminal" 只是让程序在终端跑,但断点停住后你在 Debug Console 打 console.log(chalk.red('test')),依然看不到颜色。
- 真要可视化区分日志级别,改用
console.error()/console.warn()—— Debug Console 会给它们加图标和浅色背景 - 或者在代码里加条件:开发时输出带颜色的字符串到终端,调试时用
util.inspect格式化对象,避开颜色依赖 - 别试图用
console.log('%cxxx', 'color:red')—— 这是浏览器专属,Node.js 不认%c



















