VSCode终端下的Node环境配置及常用插件-VSCode-PHP中文网

vscode终端执行node -v报错，根本原因是未继承系统node环境变量：windows因安装未勾选“add to path”或路径未生效，macos/linux因gui启动不加载~/.zshrc；需分别手动配置系统path或shell初始化文件，并彻底重启vscode验证。

vscode终端下的node环境配置及常用插件

VSCode终端里执行node -v报错，不是插件没装好，而是终端根本没继承系统Node环境——这是90%配置失败的根源。

为什么VSCode终端找不到`node`命令

VSCode集成终端默认继承当前shell的环境变量，但Windows的PowerShell/CMD、macOS的zsh/bash可能加载了不同配置文件，而VSCode有时只读取部分路径。常见表现是：系统终端能跑node -v，VSCode里却提示command not found。

Windows用户检查安装时是否勾选Add to PATH；若没勾，手动把C:\Program Files\nodejs\（或你自定义的安装路径）加进系统环境变量Path
macOS/Linux用户运行which node，确认输出路径已写入~/.zshrc或~/.bash_profile，然后在VSCode里执行source ~/.zshrc，或直接重启VSCode
VSCode设置里可显式指定terminal.integrated.env.linux（或对应平台）补全PATH，例如：{"PATH": "/usr/local/bin:/opt/homebrew/bin:${env:PATH}"}

`launch.json`中`program`字段填什么才不报错

调试启动失败最常见的原因是program指向了一个不存在的文件，或者路径没按实际项目结构写对。

VSCode 1.118

微软正式发布 Visual Studio Code 1.118 版本。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控。

下载

临时调试当前打开的文件：用"${file}"，但注意——它不会自动保存未保存的文件，调试前务必Ctrl+S或Cmd+S
固定入口文件（如index.js或app.js）：写成"${workspaceFolder}/index.js"，确保该文件真实存在且有可执行代码
ESM项目（含"type": "module"）必须加"env": {"NODE_OPTIONS": "--enable-source-maps"}，否则断点失效
TypeScript项目别填.ts源码，应填编译后路径，比如"${workspaceFolder}/dist/index.js"

真正影响调试体验的Node相关插件就这3个

@vscode/node-extension-pack是个合集包，里面多数子插件对日常调试无实质帮助，装多了反而拖慢启动速度。

必装：Debugger for Node.js（调试器本体）、ESLint（配合.eslintrc.js做语法检查）、Prettier（配.prettierrc做格式化），三者联动才能实现保存即校验+格式化
可选：npm Intellisense补全require()路径，但对ESM的import支持弱；Path Intellisense对相对路径补全更稳
慎用：Auto Import在大型项目里容易把import顺序搞乱，尤其和ESLint的import/order规则冲突

`nodemon`在VSCode里不生效怎么办

很多人想用nodemon热重载调试，但在VSCode终端里执行nodemon app.js报command not found，其实问题不在nodemon本身。

先确认npm install -g nodemon是否成功，再运行which nodemon看路径；如果路径不在系统PATH里，VSCode终端就找不到
改全局路径后（如npm config set prefix "D:\npm-global"），必须把该路径加进系统环境变量，否则VSCode终端无法识别
不想全局装？直接在项目里npm install --save-dev nodemon，然后在launch.json里设"runtimeExecutable": "npx"，"runtimeArgs": ["nodemon", "${workspaceFolder}/index.js"]