翻译此页面

调试 Express

若要查看 Express 中使用的所有内部日志,请在启动应用时将 DEBUG 环境变量设置为 express:*

Terminal window
$ DEBUG=express:* node index.js

在 Windows 系统上,请使用对应的命令。

Terminal window
> $env:DEBUG = "express:*"; node index.js

Running this command on the default app generated by the express generator prints the following output:

Terminal window
$ DEBUG=express:* node ./bin/www
express:router:route new / +0ms
express:router:layer new / +1ms
express:router:route get / +1ms
express:router:layer new / +0ms
express:router:route new / +1ms
express:router:layer new / +0ms
express:router:route get / +0ms
express:router:layer new / +0ms
express:application compile etag weak +1ms
express:application compile query parser extended +0ms
express:application compile trust proxy false +0ms
express:application booting in development mode +1ms
express:router use / query +0ms
express:router:layer new / +0ms
express:router use / expressInit +0ms
express:router:layer new / +0ms
express:router use / favicon +1ms
express:router:layer new / +0ms
express:router use / logger +0ms
express:router:layer new / +0ms
express:router use / jsonParser +0ms
express:router:layer new / +1ms
express:router use / urlencodedParser +0ms
express:router:layer new / +0ms
express:router use / cookieParser +0ms
express:router:layer new / +0ms
express:router use / stylus +90ms
express:router:layer new / +0ms
express:router use / serveStatic +0ms
express:router:layer new / +0ms
express:router use / router +0ms
express:router:layer new / +1ms
express:router use /users router +0ms
express:router:layer new /users +0ms
express:router use / <anonymous> +0ms
express:router:layer new / +0ms
express:router use / <anonymous> +0ms
express:router:layer new / +0ms
express:router use / <anonymous> +0ms
express:router:layer new / +0ms

随后向该应用发送请求时,你会看到 Express 代码中指定的日志:

Terminal window
express:router dispatching GET / +4h
express:router query : / +2ms
express:router expressInit : / +0ms
express:router favicon : / +0ms
express:router logger : / +1ms
express:router jsonParser : / +0ms
express:router urlencodedParser : / +1ms
express:router cookieParser : / +0ms
express:router stylus : / +0ms
express:router serveStatic : / +2ms
express:router router : / +2ms
express:router dispatching GET / +1ms
express:view lookup "index.pug" +338ms
express:view stat "/projects/example/views/index.pug" +0ms
express:view render "/projects/example/views/index.pug" +1ms

若仅查看来自路由实现的日志,请将 DEBUG 的值设置为 express:router。 同理,若仅查看来自应用实现的日志,请将 DEBUG 的值设置为 express:application,以此类推。

express 生成的应用

express 命令生成的应用会使用 debug 模块,且其调试命名空间的作用域限定为应用名称。

例如,如果你使用 $ express sample-app 命令生成了应用,可以通过以下命令启用调试语句:

Terminal window
$ DEBUG=sample-app:* node ./bin/www

你可以通过指定以英文逗号分隔的名称列表,来启用多个调试命名空间:

Terminal window
$ DEBUG=http,mail,express:* node index.js

高级选项

在通过 Node.js 运行时,你可以设置若干环境变量来更改调试日志的行为:

NamePurpose
DEBUG启用或禁用特定的调试命名空间。
DEBUG_COLORS是否在调试输出中使用彩色显示。
DEBUG_DEPTH对象检查深度。
DEBUG_FD用于写入调试输出的文件描述符。
DEBUG_SHOW_HIDDEN显示被检查对象的隐藏属性。

Note

DEBUG_ 开头的环境变量最终会被转换为一个选项对象,供 %o/%O 格式化符使用。 See the Node.js documentation for util.inspect() for the complete list.