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。