VSCode任务失败主因是tasks.json配置不当：command路径需shell可执行，不可依赖别名或PATH；args须分项传参；跨平台命令应统一用Node脚本或cross-env；环境变量和脚本需显式配置。
VSCode 任务执行失败，绝大多数时候不是 VSCode 有问题，而是 tasks.json 中的路径、命令或 shell 环境配置不匹配当前系统或项目结构。
task.json 的 command 路径必须可被 shell 直接执行
VSCode 不会自动帮你查 PATH 或解析 npm script 别名。比如写 "command": "tsc"，但你的终端里靠 npx tsc 才能运行——这时任务就会报 Command not found。
- Windows 下优先用完整路径或加
.cmd后缀："command": "npx.cmd"或"command": "./node_modules/.bin/tsc.cmd" - macOS/Linux 下注意权限：
./node_modules/.bin/tsc必须有执行权限（chmod +x），否则报Permission denied - 避免依赖 shell 别名或函数：VSCode 启动的任务默认不加载
~/.zshrc或~/.bash_profile，别名不会生效
args 里不要手动拼接带空格的参数字符串
写成 "args": ["--outDir dist --sourceMap"] 是错的——这会被当做一个参数传给命令，而不是两个独立参数。TypeScript 会报 Unknown option '--outDir dist --sourceMap'。
OC SSH Tunnel Node Recovery
下载
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
- 正确写法是每个参数单独一项：
"args": ["--outDir", "dist", "--sourceMap"] - 路径含空格时，不用额外加引号；VSCode 会自动处理，手动加
"./my folder/main.ts"反而可能出错 - 需要传递带等号的选项（如
--target=ES2020）时，可写成"--target=ES2020"或"--target", "ES2020"，两者都合法
shell 和 command 混用时，容易忽略执行上下文
设了 "type": "shell" 并不等于“在你日常用的终端里跑”，它用的是 VSCode 内置的 shell 实例，初始工作目录是打开的文件夹根目录，且不读取你的交互式 shell 配置。
- 如果要用 npm script，推荐直接调
npm或yarn："command": "npm", "args": ["run", "build"] - 避免在
command里写npm run build && echo done——&&是 shell 功能，但此时没启用 shell 解析；应设"type": "shell"并把整条命令放command字段 - 跨平台兼容性差的写法：
"command": "del /q dist\*"（仅 Windows）或"command": "rm -rf dist"（仅 macOS/Linux）；建议统一用 Node.js 脚本或 cross-env 工具
常见错误信息对应的真实原因
看到这些输出，基本不用猜，直接按下面检查：
-
spawn tsc ENOENT→command找不到可执行文件，检查路径、是否装了包、是否用了 npx -
Cannot find module 'typescript'→ 当前工作区 node_modules 里没装 TypeScript，或用了全局安装但 VSCode 没继承环境变量 -
The terminal process failed to launch→terminal.integrated.defaultProfile.*配置异常，或 shell 路径被改过（比如从pwsh改成不存在的fish） - 任务静默退出、无任何输出 → 很可能是
isBackground: true但没配problemMatcher，VSCode 认为任务“还没开始”就结束了
最常被忽略的一点：VSCode 的任务系统不会自动识别 package.json 里的 script，也不会读取 .env 文件。所有路径、环境变量、参数都要显式写进 tasks.json，或者用 env 字段注入。
