VSCode调试任务中添加预启动任务的逻辑-VSCode-PHP中文网

prelaunchtasks必须严格匹配tasks.json中task的name字段值，而非label或其他别名；name需为唯一字符串，大小写、空格、标点均需完全一致，否则调试启动时提示“找不到独特任务”。

vscode调试任务中添加预启动任务的逻辑

preLaunchTasks 必须引用 tasks.json 中的 task.name

VSCode 的 preLaunchTasks 不是任意字符串，它必须严格匹配 tasks.json 里某个 task 的 name 字段值——注意是 name，不是 taskName、label 或其他别名。你之前用 "taskname": "launch-core" 是无效的，VSCode 根本不识别这个字段。

常见错误现象：找不到独特的任务"启动核心"，本质就是 launch.json 里写的名称和 tasks.json 里定义的 name 对不上，或大小写/空格/中文标点不一致。

tasks.json 中每个 task 必须有且仅有一个 name 字段（字符串类型），它是唯一标识符
preLaunchTasks 只接受字符串数组，例如 ["core-launch", "manager-start"]，不能是对象或带额外属性
如果引用了不存在的 name，VSCode 不会报语法错误，而是在调试启动时弹出“找不到独特任务”提示

多进程预启动：用 shell 命令组合还是拆成多个 task？

你想在调试前启动三个 Node 进程（manager、adapter、core），有两种主流做法：单个 task 用 shell 合并命令，或拆成三个独立 task 并列执行。前者简单但难调试；后者可单独重试、查看各自输出，推荐用于开发阶段。

Windows 下建议拆开写，避免 start 命令行为不稳定（比如窗口闪退、进程未真正后台运行）：

VSCode 1.118

微软正式发布 Visual Studio Code 1.118 版本。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控。

下载

每个 task 的 type 设为 shell，command 直接写 node，用 args 指定脚本路径和工作目录
加 "group": "build" 或 "group": "none" 控制是否在终端中聚合显示
用 "presentation": { "echo": true, "reveal": "never", "focus": false, "panel": "shared", "showReuseMessage": true } 避免每次弹新终端

示例片段（tasks.json）：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "start-manager",
      "name": "start-manager",
      "type": "shell",
      "command": "node",
      "args": ["manager.js"],
      "options": { "cwd": "${workspaceFolder}/manager" },
      "presentation": { "panel": "shared" }
    },
    {
      "label": "start-core",
      "name": "start-core",
      "type": "shell",
      "command": "node",
      "args": ["core.js"],
      "options": { "cwd": "${workspaceFolder}/core" },
      "presentation": { "panel": "shared" }
    }
  ]
}

launch.json 中 preLaunchTasks 的执行顺序与失败处理

preLaunchTasks 是串行执行的，VSCode 会按数组顺序逐个运行 task，**任一 task 退出码非 0，整个预启动就中断，后续调试不会开始**。这点常被忽略，导致你以为“core 启动失败但 manager 还在跑”，其实 manager 成功后 core 失败，调试根本没触发。

默认情况下，VSCode 不等待进程长期存活——它只等命令本身结束（比如 node xxx.js 启动后立即返回，VSCode 就认为 task 完成）
若需确保服务已监听端口再继续，得在 task 中加健康检查逻辑（如用 wait-on 包），否则可能因竞态导致主程序连接失败
调试时想跳过预启动？临时注释掉 preLaunchTasks 字段，比删改 tasks.json 更安全

Windows 下 node 脚本路径和 cwd 的坑

在 Windows 上用 node 启动子进程，cwd 和 args 的路径处理容易出错，尤其含空格或中文路径时。

options.cwd 必须是绝对路径或相对于 ${workspaceFolder} 的有效相对路径，不能是 ./manager/ 这种裸路径（VSCode 有时解析失败）
args 里不要拼接 cd && node —— shell 解析不可靠，跨平台也不一致；统一用 options.cwd + args: ["xxx.js"]
如果 node 命令找不到，确认系统 PATH 里有 Node.js，或改用完整路径如 "command": "C:\Program Files\nodejs\node.exe"