Debian 环境下调试 JavaScript 的实用指南
一 前端调试 Chrome DevTools 与 Firefox 开发者工具
- 在目标页面按 F12 或右键“检查”打开开发者工具，切到 Console 查看运行时错误与 Network 检查请求状态与响应。
- 在 Sources/调试器 面板设置断点、单步执行、观察调用栈与作用域变量，必要时使用“暂停异常”定位问题代码行。
- 前端问题优先用浏览器工具定位；若涉及接口异常，结合 Network 的状态码、响应体与耗时综合分析。
二 Node.js 调试 内置检查器与 VS Code
- 使用 Node.js 内置调试器：
- 启动方式：
- 普通检查：node --inspect your-script.js
- 首行断点：node --inspect-brk your-script.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}/your-script.js”
}
]
}
- 选择配置并点击“开始调试”。
- 使用 nodemon 热重载配合调试：
- 全局安装：npm install -g nodemon
- 调试启动：nodemon --inspect-brk src/your-script.js
- 或在 nodemon.json 中配置 “exec”: “node --inspect-brk src/your-script.js”。
三 服务端日志定位与问题排查
- 定位日志文件：
- 系统日志：/var/log/syslog
- Web 服务器：/var/log/apache2/error.log、/var/log/nginx/error.log
- Node.js 应用：通常在应用目录或配置文件指定路径（如 app.log）。
- 查看与分析：
- 实时查看：tail -f /var/log/nginx/error.log
- 关键字检索：grep -i “error|exception|failed” /var/log/syslog
- 结合错误类型快速判断：
- ReferenceError：引用未定义变量
- TypeError：对不期望类型执行操作
- SyntaxError：语法错误
- RangeError：数值超出有效范围
- 前端配合 Console/Network，后端结合服务日志与依赖版本，必要时在测试环境复现。
四 高效调试的小技巧
- 合理使用 console.log/debugger 语句快速验证分支与数据；上线前清理或移除。
- 使用 ESLint/JSHint 做静态检查，提前发现潜在错误与风格问题。
- 依赖冲突或不兼容时，核对 package.json 版本并回退/升级；多浏览器与设备测试以排除兼容性问题。
- 服务器性能或网络异常也会导致“疑似 JS 问题”，用 top/htop/free 与网络工具排查资源与连通性。
