温馨提示×

Node.js在Debian上如何进行代码调试

小樊
43
2025-09-21 18:25:49
栏目: 编程语言

使用Node.js内置调试器(命令行方式)
在Debian终端中,通过--inspect--inspect-brk标志启动Node.js应用,前者启动后继续执行代码,后者会在第一行暂停。例如:

node --inspect-brk your-script.js 

启动后,终端会显示调试服务器地址(默认端口9229),如:Debugger listening on ws://127.0.0.1:9229/xxxxxx

使用Chrome DevTools图形化调试

  1. 启动应用后,打开Chrome浏览器,访问chrome://inspect
  2. 在“Remote Target”部分找到你的Node.js应用(如“localhost:9229”),点击“inspect”链接。
  3. 这会打开Chrome DevTools,你可以:
    • 在代码左侧点击设置断点;
    • 使用“Step Over”“Step Into”等按钮单步执行;
    • 查看变量值、调用栈、控制台输出等信息。

使用Visual Studio Code(VSCode)调试
VSCode是Debian下常用的调试工具,配置步骤如下:

  1. 打开项目文件夹,在左侧边栏点击“运行和调试”图标(或按Ctrl+Shift+D)。
  2. 点击“创建launch.json文件”,选择“Node.js”环境。
  3. 修改生成的launch.json文件,配置启动参数(以your-script.js为例):
{ "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "Launch Program", "program": "${workspaceFolder}/your-script.js" } ] } 
  1. 在代码行号左侧点击设置断点,按F5启动调试。VSCode会自动附加到Node.js进程,暂停在断点处,支持变量查看、单步执行等功能。

使用nodemon实现热重载调试
nodemon可在代码修改后自动重启应用,配合调试使用能提升开发效率:

  1. 全局安装nodemon:
npm install -g nodemon 
  1. 直接启动调试:
nodemon --inspect your-script.js 
  1. 或通过nodemon.json配置(推荐):
{ "watch": ["src"], // 监控的目录 "exec": "node --inspect-brk src/your-script.js" // 启动命令 } 

配置后,运行nodemon即可自动重启并调试。

使用WebStorm等IDE调试
WebStorm等专业IDE内置了Node.js调试支持,配置步骤类似:

  1. 打开项目,点击顶部菜单“Run”→“Edit Configurations”。
  2. 点击“+”添加“Node.js”配置,设置“JavaScript file”为入口文件(如your-script.js)。
  3. 点击“Debug”按钮启动调试,IDE会提供断点、变量查看、调用栈等功能。

基础日志调试(console.log)
若无需复杂调试,可通过console.log()输出变量值、执行流程等信息,是最简单的调试方式:

const name = "John"; console.log("Name:", name); // 输出变量值 console.info("Application started"); // 输出普通信息 console.warn("This is a warning"); // 输出警告 console.error("This is an error"); // 输出错误 

也可使用Node.js内置的util模块增强日志功能:

const util = require('util'); console.log(util.inspect({ name: "John", age: 30 }, { depth: null })); // 格式化输出对象 

0