Ubuntu Node.js如何进行测试和调试

Ubuntu 下 Node.js 的测试与调试实践

一 环境准备

动手之前，得先把台子搭好。第一步，确认你的 Ubuntu 系统里 Node.js 和 npm 是否已经就位。打开终端，运行 node --version 和 npm --version 看看。如果还没安装，直接去 Node.js 官网下载适合 Ubuntu 的版本就行。安装完成后，有个好习惯：在你的项目目录下执行 npm init -y 来初始化项目。这能帮你更好地管理后续的依赖和脚本，让工作流程更清晰。

二 单元测试

代码写完了，怎么知道它靠不靠谱？单元测试就是那块“试金石”。

常用框架与生态

Node.js 的测试生态相当丰富，选对工具能让效率倍增。测试运行器和断言库方面，有几个主流选择：Mocha 以其灵活性和庞大的插件生态著称；Jest 则是“开箱即用”的典范，内置了断言、快照、模拟和覆盖率功能；追求轻量和并行执行的可以看看 A va；喜欢行为驱动开发（BDD）风格的，Jasmine 是个经典选项。除此之外，断言还可以搭配更强大的 Chai 或 power-assert；模拟外部依赖可以用 Sinon；测试 HTTP 接口时，supertest 是得力助手；而生成覆盖率报告，除了 Jest 自带的，还可以用 nyc 或基于 V8 原生覆盖支持的 c8。

快速上手示例（Mocha + assert）

光说不练假把式，我们用一个最简单的例子跑通流程：

1. 安装：在项目里执行 npm i -D mocha。
2. 写代码：创建一个 index.js，里面就一个加法函数：

   function add(a, b) { return a + b; }
   module.exports = add;

3. 写测试：在 test/ 目录下创建 add.test.js：

   const assert = require('assert');
   const add = require('../index');
   describe('add', () => {
     it('should return the sum of two numbers', () => {
       assert.strictEqual(add(1, 2), 3);
       assert.strictEqual(add(-1, 1), 0);
     });
   });

4. 运行：最后，在终端输入 npx mocha test/**/*.test.js，看到测试通过的绿勾，流程就算通了。

运行与覆盖

如果你想用更“全家桶”的方案，Jest 是个不错的选择。安装 npm i -D jest 后，在 package.json 的 scripts 里加上 "test": "jest"，之后运行 npm test 即可。想生成覆盖率报告？加个参数就行：npm test -- --coverage。当然，如果你用的是 Mocha，配合 nyc 或 c8 也能轻松生成覆盖率报告，比如运行 npx nyc npm test。

三 调试

测试能发现问题，调试则是定位和解决问题的关键。在 Ubuntu 上调试 Node.js，你有几种趁手的武器。

内置调试与 Chrome DevTools

Node.js 内置了强大的调试器，并且能和 Chrome DevTools 无缝对接。启动方式有两种：一种是 node --inspect app.js（默认监听 9229 端口），程序会正常运行，等待调试器连接；另一种是 node --inspect-brk app.js，它会在第一行代码处就暂停，方便你从头开始跟踪。启动后，打开本地的 Chrome 或 Edge 浏览器，访问 chrome://inspect 或 edge://inspect，在 “Remote Target” 区域就能看到你的 Node.js 进程，点击 “inspect”，一个熟悉的开发者工具窗口就会弹出，断点、调用栈、变量查看，样样俱全。

VS Code 调试

对于习惯在 IDE 里工作的开发者，VS Code 提供了极佳的调试体验。本地调试很简单：打开“运行与调试”面板，创建一份 launch.json 配置文件，选择 Node.js 环境。一份常用的配置模板如下：

{
  "version": "0.2.0",
  "configurations": [{
    "type": "node",
    "request": "launch",
    "name": "Launch Program",
    "program": "${workspaceFolder}/app.js",
    "console": "integratedTerminal"
  }]
}

远程服务器调试（VSCode Remote-SSH）

代码跑在远程 Ubuntu 服务器上怎么办？别慌。在本地 VS Code 安装 “Remote Development” 扩展包，使用其中的 Remote-SSH 功能连接到服务器。连接成功后，你就像在本地一样，可以在远端的项目文件上直接设置断点、单步执行、查看变量，所有调试操作都在本地 VS Code 界面中完成，体验非常流畅。

四 生产可观测性 日志与问题定位

应用上了生产环境，调试器不能随便挂了，这时候就得靠日志和观察手段。

高效日志是关键。对于调试信息，推荐使用 debug 这个模块，它能按命名空间控制输出，比如 DEBUG=http:* node app.js 就只输出 HTTP 相关的调试日志，很多主流框架如 Express、Koa 都内置支持它。对于生产环境的高性能日志记录，pino 是行业优选，它采用结构化 JSON 输出，性能开销极低，非常适合高并发场景。

当线上出现问题需要快速定位时，一些技巧能帮上忙：在关键路径临时加入 console.log 或 console.error 输出状态；结合 Chrome DevTools 的 Sources 面板观察异步回调的执行顺序和闭包内的变量值；如果条件允许，甚至可以直接通过 “Remote Target” 远程检查运行中的进程状态。

五 常见问题与排查清单

最后，分享几个实战中经常碰到的问题和对应的排查思路，帮你少走弯路。

• 端口与访问：调试默认使用 9229 端口。如果需要远程调试，务必确保服务器防火墙或安全组规则放行了该端口。更安全的做法是使用 SSH 隧道：ssh -L 9229:localhost:9229 user@server，然后在本地浏览器访问 chrome://inspect 即可。
• 断点未命中：首先确认启动命令是否包含了 --inspect 标志；尝试改用 --inspect-brk 确保程序在起点暂停；在 VS Code 中检查是否选择了正确的调试配置和入口文件；如果是远程调试，确认已通过 Remote-SSH 正确打开了远端的工作区。
• 版本与依赖：环境不一致是“万恶之源”。定期用 node --version 和 npm --version 确认环境版本。在更新或安装依赖后，记得执行 npm install。如果遇到一些缓存导致的诡异问题，可以尝试清理 node_modules/.cache 目录（如果存在的话）。