VSCode 通过 .vscode/tasks.json 配置外部命令任务，需指定 version、label、type、command 等字段；用 presentation 控制终端行为，dependsOn 实现任务依赖，problemMatcher 解析错误路径需匹配实际输出格式。
怎么配置 tasks.json 让 VSCode 运行自定义命令
VSCode 本身不内置构建工具，它靠 tasks.json 文件把外部命令（比如 tsc、npm run build、python script.py）包装成可触发的任务。这个文件必须放在工作区根目录的 .vscode/tasks.json 路径下，否则 VSCode 找不到。
最简可用配置长这样：
{
"version": "2.0.0",
"tasks": [
{
"label": "build-js",
"type": "shell",
"command": "tsc",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true
}
}
]
}
-
"type": "shell"表示在系统 shell 中执行；用"process"则绕过 shell，适合需要精确控制环境变量或避免 shell 解析的场景 -
"group": "build"把任务归类，之后能用Ctrl+Shift+B（Windows/Linux）或Cmd+Shift+B（macOS）快速调起默认构建任务 -
"panel": "shared"让多个任务共用一个终端面板，避免每次新开窗口；用"dedicated"则每个任务独占面板 - 如果命令不在
$PATH中（比如本地安装的npx工具），得写全路径，或在"options"里配"env"
为什么 npm run 任务执行后终端就退出，看不到错误堆栈
这是 VSCode 默认关闭任务终端导致的——尤其当命令执行完立刻退出时，面板一闪而过。关键不是改命令，而是调整 presentation 配置。
- 加
"clear": true：每次运行前清空面板，避免日志混杂 - 设
"panel": "new"：强制开新终端，适合调试阶段反复看输出 - 一定加上
"close": false：这是防止自动关闭的硬性开关，缺了就白配 - 如果用的是
"type": "process"，某些 npm 脚本（如含concurrently）可能因 stdin 绑定异常提前退出，此时换回"shell"更稳
如何让一个任务依赖另一个任务（比如先 lint 再 build）
VSCode 支持任务依赖，但只对同个 tasks.json 里的 label 生效，不跨文件、不跨工作区。
- 被依赖的任务必须有
"dependsOn"字段，值是字符串或字符串数组 - 依赖任务本身要设
"problemMatcher"或明确"runOptions"，否则 VSCode 可能判定“未完成”而卡住后续 - 注意执行顺序是深度优先：A → B → C，若 A 依赖 B，B 依赖 C，则先跑 C，再 B，最后 A
- 常见坑：
"dependsOn"的值必须和目标任务的"label"完全一致，大小写、空格、连字符都不能错
例如：
{
"label": "build",
"dependsOn": ["lint"],
"command": "tsc --build"
},
{
"label": "lint",
"command": "eslint src/"
}
使用 problemMatcher 捕获编译错误但跳转不到源码
问题通常出在路径解析上。problemMatcher 能解析错误输出并生成可点击的跳转链接，但前提是它能准确定位文件位置。
- 默认的
"$tsc"或"$eslint-stylish"匹配器假设错误中的路径是相对工作区根目录的；如果实际输出是相对src/目录的（比如src/index.ts(5,10)），就得加"fileLocation": ["relative", "src"] - Windows 下路径分隔符是
\，匹配器默认按/切分，会导致路径识别失败；显式设"fileLocation": ["absolute"]可绕过这个问题 - 如果用了 monorepo（如 pnpm workspace），错误里路径可能带包名前缀（如
packages/ui/src/button.ts），这时需配合"owner"和正则"pattern"自定义提取逻辑 - 测试是否生效：手动在终端运行对应命令，复制一行典型错误输出，贴到 VSCode 的「输出」面板 → 「任务」频道里，看能否点开
真正难的不是写配置，而是理解 VSCode 任务模型本质：它只是命令行的壳，所有行为都受限于 shell 环境、当前工作目录、以及你写的正则能不能从原始输出里捞出有效信息。路径、引号、空格、编码——这些细节漏一个，problemMatcher 就失效，依赖链就断掉，终端就关太快。
