Ctrl+Alt+N本质是Code Runner调用node $fileName，但忽略package.json的"type":"module"、工作目录及中文路径，易报错；可靠方案是用tasks.json定义任务或绑定workbench.action.terminal.sendSequence快捷键，并添加ESM参数。
VSCode 里按 Ctrl+Alt+N 运行 JS 文件，本质是调用 Code Runner 插件，但它默认行为不可靠——不读 package.json 的 "type": "module"，不处理中文路径，也不支持 process.stdin。真要提效，得绕开它，用内置终端 + 自定义任务或快捷键绑定。
为什么 Ctrl+Alt+N 在 Node.js 项目里经常失效
Code Runner 的 Ctrl+Alt+N 是“单文件即席执行”，不是“项目上下文执行”。它直接调用 node $fileName，完全忽略：
-
package.json中的"type": "module"字段 → ESM 项目必报Cannot use import statement outside a module - 当前工作目录是否为项目根目录 →
require('./config')可能因路径错乱而MODULE_NOT_FOUND - 终端编码（尤其 Windows）→ 中文路径或
console.log('你好')显示乱码 - 输入流支持 →
process.stdin.on('data', ...)会卡死，无响应
用 Tasks 定义可复用的 node 运行任务
比快捷键更可控的方式：把常用命令封装成 VSCode Task，再绑定快捷键。它能继承终端环境、指定工作目录、传参、捕获错误。
- 在项目根目录建
.vscode/tasks.json，内容如下：
{
"version": "2.0.0",
"tasks": [
{
"label": "run:current",
"type": "shell",
"command": "node",
"args": ["${file}"],
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
},
"problemMatcher": []
}
]
}
- 保存后，按
Ctrl+Shift+P→ 输入Tasks: Run Task→ 选run:current即可运行当前文件 - 想绑定快捷键？打开
keybindings.json（Ctrl+Shift+P→Preferences: Open Keyboard Shortcuts (JSON)），加这段：
[
{
"key": "ctrl+alt+r",
"command": "workbench.action.terminal.runSelectedText",
"when": "editorTextFocus && editorLangId == 'javascript'"
}
]
注意：上面是示例逻辑，实际推荐用 workbench.action.terminal.sendSequence 更精准：
[
{
"key": "ctrl+alt+r",
"command": "workbench.action.terminal.sendSequence",
"args": { "text": "node ${file}\u000D" },
"when": "editorTextFocus && editorLangId == 'javascript'"
}
]
ESM 项目必须显式加参数，否则 import 就崩
Node.js 默认按 CommonJS 解析 .js 文件。哪怕你写了 "type": "module"，node index.js 仍可能报错——因为 node 命令本身没被告知启用 ESM 模式。
- 终端手动跑：必须加
--experimental-specifier-resolution=node（Node.js < 20.6）或--input-type=module（Node.js ≥ 20.6） - Tasks 或快捷键中也要带上，比如
"args": ["--experimental-specifier-resolution=node", "${file}"] - Windows 下还可能需加
-r utf-8防乱码："args": ["-r", "utf-8", "--experimental-specifier-resolution=node", "${file}"]
调试时别混用 runtimeExecutable 和 program
很多人在 launch.json 里同时写 "runtimeExecutable" 和 "program": "${file}"，结果调试器找不到入口。这两者语义冲突：
-
runtimeExecutable指定的是 Node.js 可执行文件路径（如/usr/local/bin/node） -
program指定的是要运行的 JS 脚本路径（如./src/index.js） - 如果你只调试单文件，删掉
runtimeExecutable；如果用 nvm/fnm 管理多版本，才显式设runtimeExecutable，且确保它和终端里which node输出一致
最易被忽略的一点：改完 tasks.json 或 keybindings.json 后，VSCode 不会自动重载配置——你得手动按 Ctrl+Shift+P → Developer: Reload Window，否则新快捷键压根不生效。
