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）
光说不练假把式，我们用一个最简单的例子跑通流程：
- 安装：在项目里执行
npm i -D mocha。 - 写代码：创建一个
index.js，里面就一个加法函数：function add(a, b) { return a + b; } module.exports = add; - 写测试：在
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); }); }); - 运行：最后，在终端输入
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"
}]
}--inspect 标志启动应用，VS Code 就会自动附加调试器，命中断点。
远程服务器调试（VSCode Remote-SSH）
代码跑在远程 Ubuntu 服务器上怎么办？别慌。在本地 VS Code 安装 “Remote Development” 扩展包，使用其中的 Remote-SSH 功能连接到服务器。连接成功后，你就像在本地一样，可以在远端的项目文件上直接设置断点、单步执行、查看变量，所有调试操作都在本地 VS Code 界面中完成，体验非常流畅。
四 生产可观测性 日志与问题定位
应用上了生产环境，调试器不能随便挂了，这时候就得靠日志和观察手段。
高效日志是关键。对于调试信息，推荐使用 debug 这个模块，它能按命名空间控制输出，比如 DEBUG=https:* 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目录（如果存在的话）。
