VSCode自定义启动任务需isBackground、problemMatcher和启动信号三者对齐，否则卡在“正在运行”；须设isBackground:true、用自定义problemMatcher捕获启动成功日志、command与args分离、合理配置presentation参数。
VSCode 自定义启动任务不是“配完就能跑”，关键在 isBackground、problemMatcher 和启动信号三者必须对齐，否则任务卡在“正在运行”或错误不显示。
为什么你的“启动服务”任务总卡在“正在运行”状态
常见现象是：执行 npm run dev 或 python app.py 后，终端一直显示“正在运行”，但服务实际已启动，且 Ctrl+Shift+B 无法再次触发——这是没告诉 VSCode “这任务会长期运行，别等它退出”。
-
isBackground: true必须显式设置，否则 VSCode 默认等待进程退出 - 设置了
isBackground: true却没配problemMatcher，会导致任务无法被识别为“已就绪”，后续操作（如自动打开浏览器）无法联动 - 对于 Node.js 服务，通常需匹配启动成功的日志行（如
Listening on http://），不能直接用$node这类通用 matcher
如何让 npm run dev 成为真正可管理的启动任务
直接写 "command": "npm run dev" 是错的——type: "shell" 下，command 只能是程序名，参数必须进 args。
- 正确写法：
"command": "npm"，"args": ["run", "dev"] - 加
"isBackground": true告诉 VSCode 这是守护进程 - 用自定义
problemMatcher捕获启动完成信号，例如：{ "owner": "dev-server", "pattern": { "regexp": "^(?:\[.*?\]\s+)?(Listening on http://.*)$", "file": "", "line": "", "column": "", "message": 1 }, "background": { "activeOnStart": true, "beginsPattern": "Starting development server", "endsPattern": "Listening on http://" } }
presentation 控制终端行为的关键参数
启动任务默认会抢焦点、弹出新终端面板，干扰编码流。用 presentation 可收敛行为：
-
"reveal": "silent"：不自动展开终端，只在后台运行 -
"echo": false：不重复打印命令本身（避免日志污染） -
"panel": "shared"：复用已有终端面板，而不是每次开新 tab -
"clear": true：每次运行前清空终端历史（适合调试频繁重启的服务）
多根工作区下启动任务容易失效的隐藏点
如果你在多文件夹工作区里配置了 .vscode/tasks.json，但任务列表里看不到它：
- VSCode 不继承父级或兄弟文件夹的 tasks 配置，每个文件夹必须有自己独立的
.vscode/tasks.json - 哪怕只在一个子文件夹里放了
package.json和tasks.json，其他文件夹的任务也不会自动出现 - 检查文件编码：BOM 头会让 JSON 解析失败，错误提示是
Invalid character in identifier，用 VSCode 右下角编码切换为UTF-8并保存
启动任务最难的不是写命令，而是让 VSCode 理解“什么时候算启动成功”和“什么时候该让它继续运行”。这两点没对齐，任务就只是个带 UI 的 shell 调用而已。
