使用babel-node调试Node.js ES6代码时kexec模块缺失的环境问题

以下是针对该问题的几种可行解决方案，按推荐优先级排序：

方案1：通过npm命令启动调试（推荐） #

直接复用你现有的npm run dev逻辑，避免直接调用babel-node引发的依赖问题。修改.vscode/launch.json如下：

{
    "name": "Debug via npm dev",
    "type": "node",
    "request": "launch",
    "runtimeExecutable": "npm",
    "runtimeArgs": ["run", "dev"],
    "console": "integratedTerminal",
    "sourceMaps": true,
    "env": {
        "NODE_ENV": "development"
    },
    "skipFiles": [
        "${workspaceFolder}/node_modules/**/*.js",
        "<node_internals>/**/*.js"
    ]
}

该配置会直接执行npm run dev，和你日常启动开发服务的逻辑完全一致，同时VS Code能自动识别source map完成调试，无需手动选择进程。

方案2：预编译代码后调试 #

绕过babel-node，先用@babel/cli编译代码再调试：

1. 安装依赖（未安装时执行）：

npm install --save-dev @babel/cli

2. 在package.json中添加编译命令：

"scripts": {
    "build:dev": "babel src --out-dir dist --source-maps inline",
    "dev:debug": "node dist/server.js"
}

3. 修改launch.json：

{
    "name": "Debug compiled code",
    "type": "node",
    "request": "launch",
    "program": "${workspaceFolder}/dist/server.js",
    "stopOnEntry": false,
    "sourceMaps": true,
    "preLaunchTask": "npm: build:dev",
    "env": {
        "NODE_ENV": "development"
    },
    "skipFiles": [
        "${workspaceFolder}/node_modules/**/*.js",
        "<node_internals>/**/*.js"
    ]
}

4. 创建.vscode/tasks.json配置预编译任务：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "npm: build:dev",
            "type": "npm",
            "script": "build:dev",
            "group": "build",
            "problemMatcher": []
        }
    ]
}

启动调试时会自动先编译代码，再运行编译后的文件，彻底避开babel-node的kexec依赖问题。

方案3：修复Windows环境下kexec的安装问题 #

kexec是原生模块，Windows下需要编译环境，可尝试以下步骤解决安装失败：

1. 安装Windows构建工具：

npm install --global windows-build-tools

若命令失败，可手动安装Visual Studio Build Tools，勾选「使用C++的桌面开发」工作负载。
2. 指定npm使用Python 2.7（部分旧版原生模块依赖）：

npm config set python python2.7

3. 重新安装依赖：

npm uninstall @babel/node kexec
npm install --save-dev @babel/node

若仍失败，可指定兼容版本：

npm install kexec@3.0.0 --save-dev

问题原因 #

kexec是@babel/node的依赖，用于进程替换，但Windows环境下原生模块编译容易出现兼容性问题。npm run dev中nodemon调用babel-node时，依赖加载路径或环境变量与VS Code直接调用不同，因此未触发错误；附加调试则是连接到已运行的进程，绕开了启动阶段的依赖加载环节。

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