VSCode调试Express单元测试的关键是让node以调试模式启动测试运行器（如mocha或jest），而非直接执行测试文件；需正确配置launch.json的program（指向mocha/jest可执行路径）和args（传测试路径及参数），避免app.listen()等真实服务启动，使用mock req/res单独测试路由处理器，并注意跨平台路径兼容性与skipFiles设置。
VSCode 调试 Express 单元测试，核心不是“装一堆插件”，而是让 node 进程以调试模式启动测试运行器（如 mocha 或 jest），同时确保测试代码能被断点命中。关键在 launch.json 的 program 和 args 配置，而不是改测试框架本身。
launch.json 中 program 必须指向测试运行器入口，不是你的 test 文件
常见错误是把 program 设成 "${workspaceFolder}/test/app.test.js" —— 这会让 VSCode 直接用 node 执行测试文件，跳过 mocha/jest 的加载逻辑，断点失效、钩子函数（beforeEach 等）不触发。
-
program应设为测试运行器的可执行路径：对全局安装的 mocha，用"${npmBin}/mocha"；对本地安装，推荐"./node_modules/.bin/mocha"（Windows 下是.\node_modules\.bin\mocha.cmd） -
args里传测试文件路径，例如["--timeout", "10000", "test/**/*.test.js"] - 如果用
jest，program改为"./node_modules/.bin/jest"，args加["--runInBand", "--no-cache"]（--runInBand是必须的，否则调试器无法 attach 到子进程）
调试 Express 路由处理器时，必须 mock req/res，不能直接跑 server.listen()
你在 test/app.test.js 里写 app.listen(3000) 再去调试？不行。这会真正监听端口，且测试运行器无法控制生命周期，断点可能根本没机会触发，还会报 EADDRINUSE。
- Express 路由函数（如
app.get('/user', handler)中的handler）要单独导出、单独测试 - 用
node-mocks-http创建req和res模拟对象，把 handler 当普通函数调用：handler(mockReq, mockRes) - 确保测试文件里没有
app.listen()、server.close()等实际启动/关闭服务的代码
node_modules 路径和跨平台兼容性容易翻车
./node_modules/.bin/mocha 在 macOS/Linux 可行，但在 Windows 上直接执行会失败，因为它是 cmd/bat 脚本，VSCode 默认用 shell 启动，不识别 .cmd 后缀。
- Windows 用户必须显式写
.\node_modules\.bin\mocha.cmd（注意反斜杠和 .cmd） - 更稳妥的做法是统一用
npm exec：把program设为"npm"，args设为["exec", "--no-warnings", "mocha", "--timeout", "10000", "test/**/*.test.js"] - 检查
package.json中是否已定义"test": "mocha test/**/*.test.js"，然后program可设为"npm"，args为["run", "test"]—— 这种方式最兼容，但需确保 npm script 里没加--inspect类参数，否则会冲突
断点不生效？先关掉 skipFiles 里的 <node_internals>/**
VSCode 默认跳过 Node.js 内部模块，但 mocha/jest 的启动链路（比如 mocha/lib/cli/cli.js）常被误判为 internals，导致断点永远不命中。
- 在 launch.json 的配置中，删掉或注释掉
"skipFiles": ["<node_internals>/**"]</node_internals>这一行 - 如果仍不行，手动在
args里加--inspect-brk（mocha）或--inspect-brk（jest），再配合"type": "node"+"request": "attach"的附加模式（不推荐初学者用） - 验证方法：在测试文件第一行加
debugger;，启动调试后看是否停住 —— 停不住就是启动链路被跳过了
最易被忽略的一点：Express 测试代码里所有 require 路径必须相对于测试文件，而不是相对于项目根目录；一旦用了 ../src/index.js 这类相对路径，而你的 test 目录结构和 src 不匹配，Cannot find module 就会静默出现，断点根本不会加载。先确保 node test/app.test.js 能在终端跑通，再进 VSCode 调试。
