使用launch.json在VS Code中调试Mocha测试失败

你的问题根源在于Mocha的测试接口模式不匹配：

你在launch.json里指定了-u tdd（TDD接口模式），但你的测试代码用的是Mocha默认的BDD风格函数（describe/it/before）。TDD模式下Mocha只会注入suite/test/setup这类全局函数，不会提供BDD的那些，所以才会抛出未定义的错误。

修复方案（二选一） #

方案1：修改launch.json，切换到BDD接口

把配置里的"-u", "tdd"这两行删掉，或者改成"-u", "bdd"（Mocha默认就是BDD，删掉也可以）。修改后的配置示例：

{
    "version": "0.2.0",
    "configurations": [
        {
            "args": [
                "--timeout",
                "999999",
                "--colors",
                "${workspaceFolder}/test/**/*.test.js"
            ],
            "internalConsoleOptions": "openOnSessionStart",
            "name": "Mocha Tests",
            "program": "${workspaceFolder}/node_modules/mocha/bin/mocha.js",
            "request": "launch",
            "skipFiles": [
                "<node_internals>/**"
            ],
            "type": "node"
        }
    ]
}

方案2：修改测试代码适配TDD模式

如果非要用TDD模式，把测试里的函数替换成TDD对应项：

• describe → suite
• it → test
• before → setup
• after → teardown

额外排查点 #

如果改完还是报错，检查：

• 测试文件里有没有开启严格模式（'use strict'）导致全局变量无法访问？可以试试去掉严格模式，或者手动引入Mocha的接口（比如const { describe, it } = require('mocha')）
• 有没有在Mocha配置（比如.mocharc.json）里覆盖了接口设置？确保配置统一

内容的提问来源于stack exchange，提问作者Rosendo Martinez