VSCode找不到node的根本原因是环境变量未正确继承：macOS/Linux因Shell初始化文件未加载，Windows因安装时未勾选“Add to PATH”；需分别通过终端启动code、重装Node或手动配置PATH解决。
VSCode 本身不带 Node.js，所有运行、调试、补全能力都依赖你系统里已安装且能被正确找到的 node 命令。如果终端里 node -v 有输出，但 VSCode 里报 command not found: node，问题一定出在环境变量继承上，不是插件、不是设置、也不是 VSCode 故障。
VSCode 启动时找不到 node：Mac/Linux 用户常见原因与修复
根本原因是 Dock、Spotlight 或桌面图标启动 VSCode 时，没加载你的 Shell 初始化文件（比如 ~/.zshrc），导致 PATH 里没有 node 的路径。
- 先在终端运行
which node，确认路径（如/opt/homebrew/bin/node或/usr/local/bin/node） - 检查该路径是否已加进
~/.zshrc（或~/.bash_profile）里的export PATH="...:$PATH" - 改完后别只
source ~/.zshrc，必须彻底退出所有 VSCode 进程，再从终端执行code --no-sandbox .启动 - 验证方式：打开 VSCode 内置终端（
Ctrl + `），直接输node -v—— 必须有输出才继续下一步
Windows 下 node 不可用：重装或手动补 PATH 是最稳解法
绝大多数情况是安装 Node.js 时没勾选 “Add to PATH”。VSCode 启动时读的是系统级 PATH，不是你某个终端临时改的。
Wjs Localizing Video
下载
用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
- 打开「系统属性 → 高级 → 环境变量」，在「系统变量」或「用户变量」的
PATH里确认是否包含C:\Program Files\nodejs\ - 如果没有，手动添加；如果有但依然无效，大概率是安装时漏勾了 —— 直接去官网重新下载 LTS 版，安装过程中**务必勾选 “Add to PATH”**
- 改完 PATH 后，必须彻底关闭所有 VSCode 窗口（包括后台进程），再重新打开
- 验证同上：内置终端中执行
node -v和npm -v，两个都得有输出
launch.json 调试失败：program 路径和模块类型必须匹配
调试器找不到入口、断点不命中、提示 “Cannot launch program because corresponding JavaScript cannot be found”，几乎都卡在这两处。
-
"program": "${file}"只适合单文件快速测试；真实项目请显式写成"program": "${workspaceFolder}/src/index.js"或"program": "${workspaceFolder}/dist/index.js" - ESM 项目必须在
package.json中声明"type": "module"，否则调试器按 CommonJS 解析，import路径会错乱 - TypeScript 项目：确保
tsconfig.json里"sourceMaps": true，且编译后.js.map和.js在同一目录 - 用了
ts-node？别设program指向.ts文件，改用"runtimeExecutable": "ts-node"并配"runtimeArgs": ["--esm"]
用 code-runner 跑脚本却乱码/卡死/不支持 import
这个插件默认命令极简：node $fileName，不处理编码、模块解析、输入流，尤其在 Windows 中文路径或 ESM 场景下必出问题。
- 防乱码（仅 Windows）：在设置里搜
code-runner.executorMap，把javascript对应值改成"node -r utf-8 $fileName" - 支持
import（ESM）：改成"node --experimental-specifier-resolution=node $fileName" - 含
process.stdin的交互式脚本——code-runner完全不支持输入，换用内置终端手动执行，或改用 F5 调试模式 - 真正想快速测试片段？用 VS Code 自带的
JavaScript Debug Terminal（命令面板输入并执行），它才是真正的 REPL
最容易被忽略的一点：所有配置都建立在 node -v 在 VSCode 内置终端中能成功执行的基础上。其他任何调试、补全、格式化的问题，都是这一步没走稳的衍生产物。别跳过验证，也别迷信“重装插件”或“重置设置”——先让 node 在终端里稳稳跑起来，后面的事才真正开始。
