根本原因是vscode未继承shell环境变量:macos/linux因dock启动不加载~/.zshrc,windows因安装时未勾选“add to path”;需彻底退出vscode进程并从终端执行code .启动,或修改terminal.integrated.shellargs为["-l"]后重启。

node 命令在 VSCode 内置终端里报 command not found,但系统终端里能正常运行 —— 这不是 Node.js 损坏了,而是 VSCode 启动时没继承你 Shell 的环境变量。重装 Node.js 或插件毫无意义,真正要重做的只有环境变量继承路径。
Mac/Linux:VSCode 启动不读 ~/.zshrc 是主因
Dock、Spotlight 或桌面图标启动 VSCode 时,它用的是 login shell 的最小环境,不会 source 你的 ~/.zshrc(或 ~/.bash_profile),所以 PATH 里没有 node 路径。
- 先在终端执行
which node,记下输出路径(比如/opt/homebrew/bin/node) - 确认该路径已写进
~/.zshrc,形如:export PATH="/opt/homebrew/bin:$PATH" - 改完后别只
source ~/.zshrc—— 必须彻底退出所有 VSCode 进程(包括菜单栏里的 Helper 进程),再从终端执行code --no-sandbox .启动 - 打开内置终端(
Ctrl + `),直接输node -v验证;有输出才说明环境继承成功
Windows:PATH 没生效,重装比手动修更稳
绝大多数“VSCode 找不到 node”问题,根源是安装 Node.js 时没勾选 Add to PATH。系统级 PATH 修改后,VSCode 不会热加载,必须重启全部进程。
用于端到端视频本地化流程的轻量编排器,路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
- 打开「系统属性 → 高级 → 环境变量」,检查「系统变量」的
PATH是否含C:\Program Files\nodejs\ - 如果没出现,或路径明显不对(比如指向旧版本),不要手动修补 —— 直接去官网下载最新 LTS 版,安装时务必勾选 “Add to PATH”
- 安装完成后,任务管理器里结束所有
Code.exe和Code Helper进程,再重新打开 VSCode - 内置终端中同时验证
node -v和npm -v,两个都得有输出才算真正就位
调试器报 Cannot find runtime 'node'?和终端能跑是两回事
VSCode 调试器不依赖终端 PATH,它要么查全局 PATH,要么认 launch.json 里写的 runtimeExecutable。终端能跑 node ≠ 调试器能定位它。
- 检查项目根目录是否有
.vscode/launch.json;如果有,删掉里面显式指定runtimeExecutable的行(除非你真用了nvm或volta) - 如果用了
nvm,调试器默认不识别当前 shell 切换的版本 —— 此时必须在launch.json中硬编码路径,例如:"runtimeExecutable": "~/.nvm/versions/node/v20.15.0/bin/node" - 若项目用 TypeScript +
ts-node,别把"program"指向.ts文件;改用"runtimeExecutable": "ts-node",并确保ts-node已全局安装
自动补全/跳转失效?不是 Node.js 环境问题
这和 node 命令能否运行完全无关,是 VSCode 的语言服务没激活或配置错位。
- 确保项目根目录有
package.json,且含"type": "module"或"type": "commonjs"字段(否则模块解析会乱) - 新建
jsconfig.json(JS 项目)或tsconfig.json(TS 项目),至少包含:{"compilerOptions": {"allowJs": true}} - 禁用所有第三方 JS/TS 插件(尤其那些叫“Enhanced JavaScript”的),VSCode 内置语言服务已足够,插件冲突反而导致跳转失败
node 的完整 PATH。手动改 PATH、reload window、重启进程这些动作,漏掉任何一环都会白忙。










