在 Debian 中调试 JavaScript 的高效方法
一 环境准备
- 安装 Node.js 与 npm（Debian 12 仓库通常提供足够新的版本）：
- 更新索引并安装：
sudo apt update && sudo apt install -y nodejs npm
- 验证版本：
node -v、npm -v
- 可选：安装 Chrome/Chromium 以便使用 DevTools 进行前端或 Node.js 调试（图形界面环境更方便）。
二 前端 JS 调试步骤
- 在目标页面按 F12 或右键“检查”打开 开发者工具，进入 Sources/Debugger 面板：
- 在代码行号处点击设置断点；使用 Step over/into/out、观察 Scope/Call Stack、在 Console 中执行临时代码。
- 通过 Network 面板查看请求与响应、状态码、耗时与请求头/响应头，定位接口问题。
- 无图形界面服务器场景：
- 启动 Chromium/Chrome 的远程调试端口：
google-chrome --remote-debugging-port=9222 --no-sandbox --disable-gpu --user-data-dir=/tmp/chrome-debug
- 本机访问 http://localhost:9222/json 获取可调试页面的 WebSocket Debugger URL，用支持 CDP 的工具（如 Puppeteer/Playwright）或 Chrome DevTools 连接调试。
- 远程服务器需开放 9222 端口并配置防火墙规则，确保调试通道可达。
三 Node.js 调试步骤
- 使用 –inspect 或 –inspect-brk 启动应用（默认调试端口 9229）：
- 普通启动：
node --inspect app.js
- 首行暂停：
node --inspect-brk app.js
- 在 Chrome 打开 chrome://inspect，在 Remote Target 中点击 Inspect 进入 DevTools 进行断点、单步、观察表达式等调试。
- 使用 VS Code 图形化调试：
- 在项目根目录创建 .vscode/launch.json，示例：
{
“version”: “0.2.0”,
“configurations”: [
{
“type”: “node”,
“request”: “launch”,
“name”: “Launch Program”,
“program”: “${workspaceFolder}/app.js”,
“skipFiles”: [“<node_internals>/**”]
}
]
}
- 按 F5 启动调试，断点与变量面板可直接使用。
- 使用 nodemon 热重载配合调试：
- 安装：
npm i -g nodemon
- 配置 nodemon.json：
{
“watch”: [“src”],
“exec”: “node --inspect-brk src/app.js”
}
- 启动：
nodemon，代码变更将自动重启并在首行暂停，便于快速迭代。
四 服务端日志与错误定位
- 应用日志：Node.js 应用常写入自定义日志文件（如 app.log），使用
tail -f app.log 实时查看最新输出与堆栈。
- 系统与 Web 服务日志：
- 系统日志：
/var/log/syslog
- Nginx：
/var/log/nginx/error.log
- Apache：
/var/log/apache2/error.log
- 检索技巧：在日志中搜索关键字 ERROR/Exception/Failed，结合时间戳还原错误上下文，定位到具体文件与行号后回到代码修复与复测。
五 高效调试技巧与排错清单
- 代码级辅助：
- 使用 debug 模块输出分级日志：
const debug = require('debug')('app'); debug('state=%o', state);，通过环境变量控制输出范围，避免生产噪声。
- 在代码中插入 debugger; 语句，配合 –inspect-brk 或 IDE 调试器快速停到关键位置。
- 常见错误速查与预防：
- SyntaxError：语法错误，检查括号/引号/分号与 ES 版本语法。
- ReferenceError：引用未定义变量，检查作用域与导入。
- TypeError：对不期望类型执行操作，增加类型守卫或启用 TypeScript/Flow。
- RangeError：数值越界，校验数组长度/数值范围。
- 工程化预防：启用 ‘use strict’、引入 TypeScript、编写 单元测试（Jest/Mocha）、进行 代码审查 与 持续集成。
