VSCode调试Mocha失败主因是program路径错误或环境未透传：直接写"mocha"会因调试器不继承shell PATH而报spawn ENOENT；应改用"./node_modules/mocha/bin/_mocha"并配合args传测试路径、启用sourceMaps及正确配置outFiles。
VSCode 调试 Mocha 用例失败，90% 是因为 program 指向了错误的目标，或者环境没透传到子进程——不是 mocha 本身难配，而是调试器启动逻辑和 shell 环境不一致导致的。
为什么直接写 "program": "mocha" 会报 spawn mocha ENOENT
VSCode 的 Node.js 调试器不走 shell，所以找不到 node_modules/.bin/mocha（它不在 PATH 里）。全局安装的 mocha 更不可靠，团队成员版本可能不一致。
- 必须用本地路径：
"program": "./node_modules/mocha/bin/_mocha"（跨平台稳定，绕过 shell 解析） - Windows 用户别用
.cmd后缀路径，_mocha是 JS 入口，兼容性更好 - 想省事可用
npx mocha，但需配合"runtimeExecutable": "npx"和"runtimeArgs": ["mocha"]，不如直接指_mocha干净
launch.json 中 args 怎么传测试文件和参数才生效
args 不是给你的测试代码用的，是传给 _mocha 这个 JS 文件的命令行参数。你得把测试路径、超时、require 插件等都塞进去。
- 测试路径要显式列出，比如：
"test/**/*.spec.js"或具体文件"test/index.spec.js" - TS 项目必加：
"-r", "ts-node/register"（否则import报错） - 常用参数组合示例：
["--require", "ts-node/register", "--timeout", "5000", "test/**/*.spec.ts"] - 如果用了 Babel，换成
--require @babel/register；ESM 项目还要加--loader ts-node/esm
断点打在 src/ 里却不停，其实是 sourceMap 没对上
Mocha 调试的是运行时加载的代码，不是你编辑器里写的源文件。TS/JSX 项目必须让编译产物和 sourcemap 路径完全匹配，否则断点就“悬空”。
-
tsconfig.json里确保："sourceMap": true，且"outDir"和"rootDir"设置合理 -
launch.json中启用："sourceMaps": true，并指定"outFiles": ["./dist/**/*.js"]（按你实际输出目录调整） - 测试文件也要被编译：检查
tsconfig.json的include是否包含"test/**/*.ts" - 改完代码后断点还停在旧逻辑？删掉
.ts-node、node_modules/.cache，再重启 VSCode 调试会话（不是 Resume）
要不要装 JavaScript Test Explorer 扩展
它不是必须的，但能帮你快速发现测试是否被识别、一键运行单个用例、看状态图标——尤其当你有多个测试框架混用时，比纯手写 launch.json 少踩一半坑。
- 装完后在
.vscode/settings.json加一句："testExplorer.frameworks": ["mocha"] - 它会自动读取
mocha.opts或package.json中的scripts.test，但不会替代launch.json的调试能力 - 如果你只用 CLI + F5，不装也行；但一旦需要点击运行、查看覆盖率、隔离测试套件，这扩展就值回票价
最常被忽略的一点：env 透传和 autoAttachChildProcesses。异步测试、子进程 spawn、worker 线程里的代码，不打开 autoAttachChildProcesses: true，断点就永远进不去——哪怕配置全对。
