根本原因是VSCode终端未继承shell完整环境导致PATH缺失npx路径；需通过source配置文件临时修复，或在settings中手动补全PATH，任务中用"shell"类型并加-l/-k参数确保login shell启动，调试时须在launch.json中显式指定runtimeExecutable。
VSCode 里跑 npx 报 command not found，或者想用 npm run dev 却提示找不到脚本——根本不是 Node 没装好，而是 VSCode 终端没继承你 shell 的完整环境，PATH 缺了关键路径。
为什么 VSCode 终端里找不到 npx 或全局安装的命令
macOS/Linux 下 VSCode 默认不加载 ~/.zshrc 或 ~/.bash_profile，所以 $(npm config get prefix)/bin 不在 $PATH 里；Windows 下 PowerShell 和 CMD 的环境变量不互通，改了其中一个，另一个可能还是旧的。
- 验证方式：在 VSCode 内置终端执行
which npx或where npm，为空就说明路径缺失 - 临时解决：运行
source ~/.zshrc（macOS/Linux）或$env:PATH = "$env:PATH;D: odejs"（PowerShell） - 永久解法：在 VSCode 设置里补全
terminal.integrated.env.osx或terminal.integrated.env.windows，把$(npm config get prefix)/bin显式加进去（先运行npm config get prefix看实际路径）
tasks.json 中调用 npx 时静默失败怎么办
VSCode 的 task 不会自动 source shell 配置，PATH 错误时既不报错也不执行，看起来像“没反应”。
- 必须把 task 的
type设为"shell"，并加上-l参数（Linux/macOS）或/k（Windows CMD），让它以 login shell 启动 - 示例（macOS）：
"args": ["-l", "-c", "npx prettier --write src/**/*.js"]
- 别依赖
script类型——它绕过 shell，PATH 更不可控 - 如果项目本地有
node_modules/.bin，优先用相对路径调用：./node_modules/.bin/prettier，避免全局命令冲突
给常用命令起别名，不是靠 shell，而是靠 VSCode 自身机制
别在 ~/.zshrc 里写 alias npmx='npx'——VSCode 终端不一定加载它；要让别名在命令面板、快捷键、任务里都生效，得走 VSCode 的配置链路。
- 用
Command Alias扩展：在settings.json里加"command-alias.aliases"，比如{"fmt": "workbench.action.terminal.runActiveFile"}，然后Cmd+Shift+P输入fmt就触发 - 快捷键别名更可靠：在
keybindings.json里绑定{"key": "cmd+alt+f", "command": "workbench.action.terminal.runSelectedText"}，直接按键调用 - 别把别名逻辑塞进
tasks.json：它只服务当前项目，且无法被命令面板识别
调试时提示 “Can’t find Node.js binary ‘node’”，其实和 PATH 无关
这个错误不是终端找不到 node，而是 VSCode 调试器压根没读系统 PATH，它只认 launch.json 里写的 runtimeExecutable。
- 必须在项目根目录的
.vscode/launch.json中显式指定："runtimeExecutable": "/usr/local/bin/node"
（macOS）或"runtimeExecutable": "D:\nodejs\node.exe"
（Windows） - 路径中不能含空格，推荐用正斜杠或双反斜杠
- 如果用了
nvm或fnm，别写死路径——改用${env:NODE_PATH}或写个 wrapper 脚本输出真实路径
最常被忽略的一点：VSCode 修改环境变量后，必须**完全关闭并重启整个窗口**，只关终端标签页或重载窗口都不行。PATH 是启动时一次性注入的，改了设置不重启，等于没改。
