VSCode里npx报command not found的根本原因是终端未加载shell完整环境导致PATH缺失：macOS/Linux需配置terminal.integrated.shellArgs为["-l"]并重启VSCode，Windows需手动补PATH或改用code命令启动，验证用which npx或where npx，临时修复可source ~/.zshrc或修改$env:PATH。
VSCode里npx跑测试框架报command not found，不是没装包
根本原因是 VSCode 终端没加载 shell 的完整环境，npx 路径不在 PATH 里。macOS/Linux 下 $(npm config get prefix)/bin 没被自动加入，Windows 下 PowerShell 和 CMD 环境变量不互通。
验证方式：在 VSCode 内置终端执行 which npx（macOS/Linux）或 where npx（Windows），输出为空就确认路径缺失。
- 临时修复：运行
source ~/.zshrc（macOS/Linux）或$env:PATH = "$env:PATH;C:\Program Files\nodejs"（PowerShell） - 永久解法：在 VSCode 设置中配置
terminal.integrated.env.osx或terminal.integrated.env.windows，把$(npm config get prefix)/bin实际路径显式加进去（先运行npm config get prefix查路径） - 注意：改完设置后必须重启 VSCode 才生效，仅重开终端面板无效
tasks.json里用npx起jest/vitest沙箱，为什么静默失败
VSCode 的 task 默认不走 login shell，PATH 错误时既不报错也不执行，看起来像“点了没反应”。尤其调 npx jest 这类依赖全局二进制的命令时，最容易卡住。
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 必须设
"type": "shell"，不能用"process"或默认"shell"不带参数 - macOS/Linux 加
-l参数确保加载~/.zshrc；Windows CMD 加/k，PowerShell 加-ExecutionPolicy Bypass -Command - 推荐写法（macOS）：
"args": ["-l", "-c", "npx jest --runInBand ${file}"] - 更稳妥的做法：优先用项目本地
./node_modules/.bin/jest，避免全局命令冲突和路径依赖
想让npx每次装新包都进干净沙箱，得加-p参数
新版 npx 默认不查全局安装的包，只找本地 node_modules；如果没装过，又没加 -p，就会直接报 Cannot find module 'jest'——这不是包没装，是 fallback 被关了。
-
npx -p jest jest --runInBand：强制从 npm 安装并执行，用完即弃，天然沙箱 -
npx -p vitest@latest vitest run --watch：指定版本，避免本地 lockfile 干扰 - 注意：
-p后面跟包名，第二个参数才是命令名，别写成npx -p vitest run（会找不到run命令） - 性能影响：每次都要下载包，CI 场景慎用；本地开发调试可接受
ESM项目里npx调测试框架，runtimeArgs容易漏掉
如果你的 package.json 有 "type": "module"，但 npx jest 还是报 ERR_REQUIRE_ESM，问题不在 Jest 配置，而在 Node.js 启动参数没传对。
- VSCode 任务里不能只靠
npx，得让底层 Node 进程识别 ESM —— 在launch.json或 tasks 中显式加runtimeArgs - 示例：
"runtimeArgs": ["--experimental-specifier-resolution=node"] - 某些框架（如 Vitest）已内置支持，但 Jest 仍需该参数配合
type: "module"工作区 - 别指望
npx自动透传这些 flag，它只是启动器，不是 Node 运行时代理
npx -p 创建的临时 node_modules 是进程级隔离，但不会清除 require.cache 或全局状态**。比如你连续跑两次 npx -p jest，第二次可能复用第一次的模块缓存，导致 mock 失效或状态残留。需要手动加 --no-cache 或在脚本里清理 require.cache。 
