VSCode与Node环境：新手常犯的五个安装错误

很多新手在配置VSCode的Node.js环境时，明明看着安装步骤一步一步来，却总在终端里栽跟头。最典型的场景就是：node -v跑得挺顺，npm -v却直接报错，或者调试按钮按下去断点就是灰色。这些问题的根源其实不在Node.js本身，而是环境变量没传对、路径漏了一段，甚至压根没搞明白VSCode只是个编辑器、不负责运行代码。下面把五个常见错误拆开讲透，每一步都值得亲手验证。

node -v 有输出但 npm -v 报错：PATH 没传给 PowerShell

VSCode默认用PowerShell做集成终端，这玩意儿有个坑：它不会自动继承用户级的PATH变量，尤其是npm.cmd所在的%APPDATA%Roamingnpm。所以你会看到node能用，但npm就找不到。解决思路其实很简单——先确认路径存在，再手动补上。

• 在系统CMD或非VSCode内置的PowerShell里跑where npm，看看返回的路径是不是类似C:UsersXXXAppDataRoamingnpmnpm.cmd。如果是，那就说明路径本身没问题，只是VSCode没读到。
• 打开「系统环境变量」→ 编辑「Path」→ 新增这个Roaming路径（注意不是Node.js安装目录，而是这个bin目录）。
• 关掉所有VSCode进程（任务管理器里把Code.exe杀掉），再重启，按Ctrl+`打开终端，立刻试npm -v。
• 别指望安装时勾选的“Add to PATH”——它只加了Node.js目录，npm全局bin路径是漏掉的，得自己补。

装了插件就以为有 Node：VSCode 不自带运行时

这是新手最容易犯的误会：在扩展市场搜“Node.js”装了一堆插件，比如Node.js Extension Pack，就以为环境配好了。实际上这些插件只提供语法提示、调试界面和代码片段，里面根本没有node或npm的二进制文件。所以看到右键菜单里有“Run Code”就直接点？大概率会报Cannot find module 'http'或ReferenceError: require is not defined。

• 正确做法是去nodejs.org下载LTS版本（当前是v20.15.1），手动运行安装包。
• 安装时务必勾选“Add to PATH”，并且不要选带空格或中文的目录（比如C:Program Files (x86)或D:我的开发工具）。
• 验证标准不是“插件装好了”，而是终端里能跑通node -v和npm -v。

launch.json 配置缺失：断点永远不生效

VSCode的调试功能不会自动识别Node.js项目的入口文件。如果没配launch.json就直接按▶️调试，进程会启动又秒退，控制台没输出，断点也是灰色不可用。这步跳不过，必须手动配置。

• 第一次调试前，打开项目根目录下的.js文件（比如index.js），按Ctrl+Shift+D切到运行面板 → 点“创建 launch.json 文件” → 选“Node.js”环境。
• 生成的配置里，program字段必须指向真实可执行文件，比如"./index.js"，别写成"src/index.js"（除非真有这个路径）。
• 如果项目用了ES Module（含import），需要在package.json里加"type": "module"，否则调试器按CommonJS解析，路径映射会失败。
• 别跳过这步直接按F5——没有launch.json，VSCode根本不知道该启动哪个文件、用什么参数。

nvm install 后 node 还在旧版本：settings.txt 没配 root

NVM for Windows安装时选的路径只决定nvm.exe放哪，真正存Node.js版本的目录由settings.txt的root参数控制。如果不配置它，nvm install 18会把文件下载到%APPDATA%nvm，结果nvm use 18失效或找不到二进制。这就是为什么明明装了新版本，运行node -v还是旧版本。

• 先运行where nvm找到NVM安装目录，进入该目录，新建文本文件命名为settings.txt。
• 写入两行：root: D:nvm（你想要的Node存放路径）和path: D:nvm（保持一致）。
• 删掉%APPDATA%nvm下所有内容，重新运行nvm install 18，再nvm use 18。
• 验证方法：nvm list显示的路径应该与settings.txt里的root一致。

自动保存关着写半天：Ctrl+S 忘按导致代码丢失

VSCode默认不自动保存，编辑完切窗口或关标签，未保存的内容直接消失。这不是崩溃，是设计如此——但很多新手以为“改完了就生效”，结果一刷新全没了。尤其是写package.json或launch.json时，少一个逗号就报错，重写成本远高于自动保存的开销。

• 打开设置（Cmd+,或Ctrl+,），搜files.autoSave，选afterDelay（默认延迟1秒）或onFocusChange（切出编辑器即保存）。
• 顺手检查右下角状态栏：如果有“●”标记，说明文件未保存，点一下或按Ctrl+S。

真正卡住人的，从来不是node或npm本身，而是环境变量没刷新、PATH漏了一段、launch.json少一行，或者根本没意识到VSCode不是运行环境——这些细节不显眼，但每一步都得亲手验证，不能靠“看起来装了”。