VSCode中如何通过配置文件自定义Node环境的行为？

调试 Node.js 遇到 VSCode 断点不生效、路径识别错乱、中文乱码，这些事十有八九不是你代码写错了，而是配置文件和实际执行环节没对齐。launch.json 和 settings.json 这两兄弟，一个管调试器怎么跑，一个管编辑器环境怎么搭，但凡改错一处，整个行为就全偏了。

VSCode 里 Node.js 行为不按预期走，不是代码问题，而是配置文件没对上——launch.json 和 settings.json 控制着执行路径、调试模式、编码、模块解析等关键行为，改错地方就全乱。

launch.json 中 runtimeExecutable 和 runtimeArgs 怎么配才生效

VSCode 调试器默认走系统 PATH 找 node。但只要你写了 runtimeExecutable，它就彻底无视 PATH，只认你写的那个路径。最常翻车的地方有两个：一是路径写错了（比如漏了 ~ 没展开、nvm 版本号对不上），二是误把 program 当成可执行文件路径——实际上 program 是你入口 JS 文件的位置，和可执行文件是两码事。

• runtimeExecutable 必须指向真实存在的 node 二进制文件。macOS/Linux 比如 "runtimeExecutable": "~/.nvm/versions/node/v18.17.0/bin/node"，Windows 就是 "C:Program Filesnodejsnode.exe"。
• runtimeArgs 传的是给 node 进程的参数，不是给你的脚本的。比如要启用 ES 模块："runtimeArgs": ["--loader", "ts-node/esm"]，或者关掉实验性功能："runtimeArgs": ["--no-experimental-fetch"]。
• 如果用了 ts-node 或 esbuild-node 来启动，那么 runtimeExecutable 应该指向它们，比如 node_modules/.bin/ts-node，而不是 node 本身。

settings.json 里哪些 Node 相关配置真起作用

很多人以为在 settings.json 里改几行就能控制 Node 执行逻辑，其实真正影响行为的就那么一两项，剩下的不过是 UI 显示或语言服务提示。

• ja vascript.suggest.autoImports 和 typescript.suggest.autoImports 只管自动导入补全，不影响实际运行。
• terminal.integrated.env.linux / .osx / .windows 可以用来注入环境变量，比如强制 NODE_OPTIONS=--enable-source-maps，这对调试堆栈映射非常关键。
• code-runner.executorMap 是 Code Runner 插件的行为，只影响那个插件怎么执行代码。如果你不用 Code Runner，改了也白改。
• 千万别在 settings.json 里硬写 node 路径——它既不接管调试器，也不管终端启动，纯粹是个误导。

为什么断点总在 compiled.js 上停，而不是 .ts 文件

这个问题跟 VSCode 配置本身关系不大，根子在 source map（源码映射）没生成或者没被识别。调试器只认 sourceMapPathOverrides 和 outFiles 这两个配置项，而且它们必须和构建输出的路径严格对应。

• 编译时必须启用 source map：TypeScript 要开 sourceMap: true，esbuild 要加 --sourcemap，并且生成的 .map 文件要和 JS 放在同一目录。
• 在 launch.json 的 configuration 里加上："sourceMaps": true 和 "outFiles": ["${workspaceFolder}/dist/**/*.js"]（路径必须精确到文件夹）。
• 如果你用了 tsconfig.json 的 rootDir 和 outDir，那 sourceMapPathOverrides 得手动映射，比如："sourceMapPathOverrides": {"src/*": "${workspaceFolder}/src/*"}。
• 如果用的是 node --inspect attach 模式，VSCode 不会读 outFiles，只靠运行时 source map 的 URL。所以必须确保生成的 JS 文件里有 //# sourceMappingURL=xxx.map 这一行，并且路径可访问。

code-runner 插件跑 JS 为啥中文乱码或卡死

这个插件默认用 node $filename 执行，不设编码、不处理 stdin、也不捕获 stderr。一旦遇到非 ASCII 路径或者需要交互输入的情况，直接挂掉。

• Windows 下加 -r utf-8：把 code-runner.executorMap 里的 ja vascript 改成 "node -r utf-8 $fileName"。
• ESM 项目必须显式加 --experimental-specifier-resolution=node，否则 import 会报错。
• 含 process.stdin 的脚本千万别用 code-runner——它不提供输入流。要么切换到终端手动跑，要么改用 launch.json 配合 "console": "integratedTerminal"。
• 别在 $fileName 前面加 cd $dir 之类的命令：code-runner 不支持多命令链，写了就解析失败。

最容易被忽略的一点是：VSCode 里的调试器、终端、Code Runner、tasks 这四套机制，各自读取不同的配置文件。你改了 launch.json，终端里的 npm start 不会受影响；你改了 settings.json，Code Runner 的行为也不会跟着变。先搞清楚你正在调的是哪一个环节，再动手改对应的文件。