提升开发效率：VSCode中Node.js环境配置全解-VSCode-PHP中文网

vscode集成终端报“command not found”根本原因是其gui启动未加载shell配置文件（如~/.zshrc），导致path缺失；需macos/linux设terminal.integrated.shellargs为["-l"]并彻底重启，windows则需确保系统path含node路径并重启vscode。

提升开发效率：vscode中node.js环境配置全解

VSCode 里跑不了 node 命令？不是插件没装对，是环境变量根本没进 VSCode 进程。

为什么终端能 `node -v`，但 VSCode 集成终端报“command not found”

根本原因：VSCode 启动时读取的是系统启动时的环境变量快照，而不是你 shell 配置文件（如 ~/.zshrc 或 Path）里新写的 export PATH。macOS/Linux 用户尤其容易卡在这儿——Homebrew 装的 Node 默认在 /opt/homebrew/bin 或 /usr/local/bin，但 VSCode 没加载你的 shell 初始化逻辑。

macOS/Linux：检查 ~/.zshrc（或 ~/.bash_profile）是否包含类似 export PATH="/opt/homebrew/bin:$PATH"；改完后执行 source ~/.zshrc，再**完全退出 VSCode（关闭所有窗口），重新从 Dock 或命令行启动（code）**
Windows：安装 Node.js 时没勾选 “Add to PATH” 就等于白装；若已安装，手动把 C:\Program Files\nodejs\（或你自定义的路径）加到「系统变量」→「Path」里，然后重启 VSCode
验证方式：在 VSCode 集成终端里运行 echo $PATH（macOS/Linux）或 echo %PATH%（Windows），确认输出里有 Node 的 bin 目录

`code-runner` 执行 JS 文件乱码、卡死、不支持 `import`

这个插件默认用 node $fileName 粗暴执行，没处理编码、模块系统、输入流等现实问题，尤其在中文路径或 ES Module 场景下必崩。

用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

乱码（Windows）：在 VSCode 设置里搜 code-runner.executorMap，找到 javascript 对应项，改成："node -r utf-8 $fileName"
ES Module 报错 Cannot use import statement outside a module：改成："node --experimental-specifier-resolution=node $fileName"
带 process.stdin 的交互式脚本（比如 readline）会假死——code-runner 不提供 stdin 输入通道，必须切到集成终端手动运行
不想配来配去？直接禁用 code-runner，用 VSCode 内置终端：Ctrl+` → node app.js

调试时断点不命中，“Cannot launch program because corresponding JavaScript cannot be found”

VSCode 的 Node.js 调试器（vscode-js-debug）只认编译后的 .js 文件，不认 .ts、.mjs 或打包产物源码路径。常见于 TypeScript 项目或用了 type: "module" 的 package.json。

确保 .vscode/launch.json 中 program 字段指向真实存在的 .js 文件，例如："program": "${workspaceFolder}/dist/index.js"，而不是 src/index.ts
TypeScript 项目必须开启 sourceMaps: true（在 tsconfig.json 中），且编译后 .js 和 .js.map 在同一目录
ESM 项目（package.json 有 "type": "module"）：launch.json 里加 "runtimeArgs": ["--loader", "ts-node/esm"]（需先 npm install -D ts-node），或直接用 node --loader ts-node/esm src/index.ts 启动
别忘了保存文件再调试——未保存的修改不会被调试器加载

多 Node 版本共存时，VSCode 总用错版本

VSCode 默认用系统 PATH 里的第一个 node，但你可能用 nvm 切换版本，而 VSCode 启动早于 nvm use，导致它锁死旧版本。

macOS/Linux：在 VSCode 设置里搜 terminal.integrated.env，添加："PATH": "/Users/you/.nvm/versions/node/v18.18.2/bin:${env:PATH}"（把 v18.18.2 换成你当前要用的版本）
Windows：用 nvm-windows 的话，在系统环境变量里把 %NVM_HOME%\v18.18.2 提前到 Path 最前面
更稳妥的方式：在项目根目录建 .nvmrc 文件写入 18.18.2，然后在 VSCode 终端里手动执行 nvm use，再启动调试——VSCode 继承当前终端的环境