怎样开启nodejs调试日志

在 Node.js 中“开启调试日志”有多种含义，下面按常见场景给你总结，你可以按需使用。

一、开启 Node.js 自身调试日志（内部日志）

1️⃣ 使用 --trace-* 系列

node --trace-warnings app.js
node --trace-deprecation app.js
node --trace-uncaught app.js

2️⃣ 开启 V8 / 内部调试日志

node --trace-event-categories=node,uv

二、开启 Node.js Inspector 调试（最常用）

方式一：命令行调试

node --inspect app.js
# 或
node --inspect-brk app.js   # 在第一行断住

然后用：

• Chrome 浏览器访问 chrome://inspect
• 或 VS Code 的 Attach to Process

方式二：指定端口

node --inspect=9229 app.js

三、开启 NODE_DEBUG（官方模块调试日志）

Node.js 内置模块支持调试输出：

NODE_DEBUG=http,net,tls node app.js

常见可选项：

• http
• net
• tls
• cluster
• module
• timer

✅ 查看所有支持项：

console.log(process.env.NODE_DEBUG);

四、应用层调试日志（最常用）

1️⃣ 使用 DEBUG（非常流行）

DEBUG=* node app.js
DEBUG=express:* node app.js

需安装：

npm install debug

代码：

const debug = require('debug')('app');
debug('hello');

五、日志库（生产推荐）

• winston
• pino
• log4js

示例（pino）：

npm install pino

const logger = require('pino')();
logger.info('debug log');

六、环境变量汇总（速查）

NODE_DEBUG=http,net
DEBUG=*
node --inspect app.js

七、如果你愿意，我可以：

• 帮你配置 VS Code 调试
• 给你一个 Express / Koa 调试示例
• 教你 生产环境如何安全开日志

你当前是 本地调试 还是 线上排错？