VSCode终端找不到node命令，90%是环境变量未被继承：Windows因Node安装时未勾选“Add to PATH”或PowerShell与CMD环境变量不共享，macOS/Linux因GUI启动跳过~/.zshrc加载；须在VSCode终端执行which node或where node验证，无输出则需重装Node并勾选PATH、修正shell配置或手动补全PATH。
VSCode 里 node 命令不可用，90% 是环境变量没被终端继承，不是配置写错了。
为什么 VSCode 终端找不到 node？
你可能在系统终端（如 Windows CMD、macOS Terminal）里跑 node -v 没问题，但一进 VSCode 的 Ctrl+` 终端就报 command not found 或 'node' is not recognized。这不是 VSCode 故障，而是它启动时用的 shell 没加载你的环境变量。
- Windows 上 VSCode 默认用 PowerShell，而你配 PATH 可能只加在 CMD 的用户变量里
- macOS/Linux 上 VSCode 启动的是非登录 shell（比如 zsh），不会读
~/.zshrc里新增的export PATH=...，除非你显式配置 - Node 安装时没勾选 “Add to PATH”（尤其是 Windows MSI 安装器），PATH 根本没写进去
验证和修复 node 可执行性最简三步
别跳过这步直接写 launch.json——断点全灰、调试器起不来，根源都在这儿。
- 在 VSCode 里按
Ctrl+`打开终端，立刻运行：which node（macOS/Linux）或where node（Windows）；如果无输出，说明命令根本不可见 - 接着跑
npm -v，失败意味着全局工具链（比如nodemon）后续也无法调用 - 修复方式：重装 Node.js 并务必勾选 “Add to PATH”；macOS 若用 Homebrew，检查
~/.zshrc是否有export PATH="/opt/homebrew/bin:$PATH"并执行source ~/.zshrc；Windows 用户确认系统环境变量 PATH 里包含C:\Program Files\nodejs\（或你自定义的安装路径）
launch.json 中 program 路径必须是绝对路径
VSCode Node 调试器对路径极其敏感，相对路径、${workspaceRoot}、甚至少一个 / 都会导致断点失效或启动失败。
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
- 入口文件路径必须写成
${workspaceFolder}/app.js这种形式，不能写./app.js或app.js - 确保项目根目录下存在
.vscode/launch.json，最小可用配置只需包含type: "node"、request: "launch"、program和console: "integratedTerminal" - 如果用
nodemon调试，launch.json里得加runtimeArgs:["--inspect-brk"]，否则断点进不去
断点灰色、不命中？先关掉 skipFiles 和检查 Source Map
即使 node 和路径都对了，断点仍不生效，大概率是调试器跳过了源码映射。
- 打开
launch.json，确认没有设置"skipFiles": ["<node_internals>/**"]</node_internals>—— 这个默认值会屏蔽所有源码，清空它 - 确保你的代码构建过程开启了 source map（例如 TypeScript 的
tsconfig.json里"sourceMap": true，或 webpack 的devtool: "source-map"） - 如果用 Babel 编译，检查
.babelrc或babel.config.js是否启用了sourceMaps: true
真正卡住人的从来不是 launch.json 写几行，而是 node 在终端里跑不起来——这个前提不成立，后面所有配置都是空中楼阁。每次换新机器或重装系统，第一件事永远是进 VSCode 终端敲 which node 和 npm -v，而不是急着建项目。
