VSCode本身不带Node.js,必须先在系统安装并正确配置PATH,否则插件也无法运行node命令;macOS/Linux需确保shell配置文件(如~/.zshrc)加载且VSCode从终端启动,Windows需安装时勾选“Add to PATH”或手动添加C:\Program Files\nodejs\到系统环境变量。

VSCode 本身不带 Node.js,装完插件也跑不了 node 命令——必须先在系统层面装好、PATH 配对、终端能认,VSCode 才可能用起来。
node -v 在系统终端能跑,但在 VSCode 终端报 command not found
这不是 VSCode 设置问题,而是它没继承你 shell 的环境变量。Mac/Linux 用户常见于 Dock 启动 VSCode 时没加载 ~/.zshrc;Windows 用户则大概率是安装 Node.js 时漏选了 “Add to PATH”。
- Mac/Linux:打开终端执行
which node,确认路径(如/opt/homebrew/bin/node)已写进~/.zshrc的export PATH="...:$PATH";改完后必须重启 VSCode,或直接从终端运行code --no-sandbox . - Windows:右键“此电脑”→“属性”→“高级系统设置”→“环境变量”,检查
C:\Program Files\nodejs\是否出现在“系统变量”或“用户变量”的Path里;不确定就重装 Node.js,勾选 “Add Node.js to PATH” - 验证方式:关掉所有 VSCode 窗口(macOS 右键 Dock 选「退出」,Windows 任务管理器杀掉
Code.exe),再打开项目文件夹,按Ctrl+`打开内置终端,立刻执行node -v—— 这次有输出才算真正生效
launch.json 中 program 字段写死导致调试失败
VSCode 自动生成的 launch.json 默认是 "program": "${workspaceFolder}/app.js",但你实际想调试的是 server.js 或 index.js,F5 就直接报错。
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 最稳妥写法是
"program": "${file}",表示“当前打开的 JS 文件”,适合单文件快速调试 - 如果项目有固定入口(比如
src/index.js),可设为"program": "${workspaceFolder}/src/index.js",但注意路径别写错,且该文件必须存在 - 别忘了调试前手动保存文件:
Ctrl+S(Windows/Linux)或Cmd+S(macOS),VSCode 不会自动保存未存档的断点
npm install 卡住或全局工具(如 nodemon)在 VSCode 里找不到
国内直连 npm 官方源常超时,且默认全局路径在系统盘(如 C:\Users\XXX\AppData\Roaming\npm),容易占满空间,更麻烦的是 VSCode 终端可能压根读不到你改过的 prefix。
- 换镜像:
npm config set registry https://registry.npmmirror.com - 改全局路径(以 D 盘为例):
npm config set prefix "D:\npm-global",再把该路径加进系统Path(Windows)或 shell 配置(macOS/Linux) - 验证:
npm config get prefix和npm config get registry必须输出你刚设的值 - 重装工具:
npm install -g nodemon,然后在 VSCode 终端里执行nodemon index.js测试;如果提示command not found,说明终端没读到新Path,重启 VSCode 或手动source ~/.zshrc再试
断点不命中、调试器提示 Cannot find runtime 'node'
这通常不是代码问题,而是调试器压根没定位到 node 可执行文件——尤其当你用了 nvm、fnm 或 volta 这类版本管理工具时,VSCode 默认不识别它们的切换逻辑。
- 先确认
node -v在 VSCode 终端里能跑,这是前提 - 检查
.vscode/launch.json里有没有"runtimeExecutable"字段;如果有且指向一个具体路径(比如"runtimeExecutable": "~/.nvm/versions/node/v20.15.1/bin/node"),确保路径真实存在、权限正常 - 如果没写
runtimeExecutable,就删掉它,让调试器走默认查找逻辑;写了反而容易因路径失效导致失败 - TS 项目用
ts-node调试时,别直接配program,改用"runtimeArgs": ["--loader", "ts-node/esm"]并确保tsconfig.json正确
最容易被忽略的其实是环境变量的“可见范围”:系统终端能跑 node,不代表 VSCode 终端或调试器也能看到;改了 npm config,也不代表 VSCode 已加载新配置。每次改动后,关干净、重开、再验证,比反复调设置更省时间。

















