VSCode执行tasks.json中的shell任务时，本质是调用系统shell在当前工作目录执行command+args拼接的命令，不经过Node.js运行时或插件上下文；插件可通过监听onDidSaveTextDocument、registerTaskProvider动态生成任务、注入env等方式深度联动，而非直接运行任务。
VSCode 插件本身不直接参与 tasks.json 定义的构建任务执行，但能通过监听、拦截、增强或替代方式与 JS 代码构建任务深度联动。关键不在“插件运行任务”，而在“插件如何影响任务的触发、环境、输出或反馈闭环”。
tasks.json 中的 command 是怎么被实际执行的
VSCode 在执行一个 type: "shell" 任务时，本质是调用系统 shell（如 PowerShell / bash / zsh），在当前工作目录下执行 command + args 拼接后的命令字符串。它不走 Node.js 运行时，也不加载 VSCode 插件上下文。
-
command值为"npm"且args为["run", "build"]，和写成"npm run build"效果一致，但前者更利于跨平台路径处理和参数转义 - 若
command是相对路径（如"./scripts/build.js"），需确保该文件有可执行权限（Unix）或显式调用node（"node"+["./scripts/build.js"]） - 环境变量默认继承自 VSCode 启动时的 shell 环境；插件无法直接修改这个环境，但可通过
options.env字段注入（见下节）
插件如何干预构建任务的执行环境
插件不能重写 tasks.json 的执行逻辑，但可在任务启动前通过 vscode.tasks.onDidStartTask 监听，并利用 TaskProvider 动态生成任务——这才是真正可控的联动点。
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
- 使用
vscode.workspace.registerTaskProvider注册自定义 provider，返回一个Task对象，其中definition可携带插件专属字段（如buildMode: "dev"），execution可指定ShellExecution并传入options.env - 常见用途：根据当前分支名自动注入
NODE_ENV=staging；读取.env.local注入到构建命令环境；在 monorepo 中动态解析 workspace folder 决定执行哪个package.json脚本 - ⚠️ 注意：
options.env是浅合并到系统环境，不会覆盖PATH等关键变量，若需完整控制，建议封装为 wrapper shell 脚本再调用
为什么 problemMatcher 在插件里常失效
problemMatcher 是 VSCode 内置的输出解析器，只对任务终端的标准输出（stdout/stderr）按正则匹配。插件无法“注册自己的 matcher”，但容易因以下原因导致错误不显示：
- JS 构建脚本（如
rollup或自定义build.js）未将错误写入 stderr，而是混在 stdout 中 —— 必须显式用console.error()或process.stderr.write() - 使用的
problemMatcher如"$tsc"依赖 TypeScript 编译器固定格式，而自定义脚本输出格式不匹配；应改用自定义 matcher，例如：{ "owner": "custom", "fileLocation": ["relative", "${cwd}"], "pattern": { "regexp": "^(.*):([0-9]+):([0-9]+):\s+(error|warning)\s+(TS[0-9]+):\s+(.*)$", "file": 1, "line": 2, "column": 3, "severity": 4, "code": 5, "message": 6 } } - 插件中调用
vscode.tasks.executeTask()时未等待任务完成就尝试读取问题面板 —— 问题匹配是异步的，需监听vscode.tasks.onDidEndTask后再查vscode.languages.getDiagnostics()
保存即构建（save-and-build）为何经常漏触发
VSCode 的“保存时运行任务”功能（"runner": "onSave"）仅对文件扩展名匹配生效，且不支持 glob 或条件判断，JS 构建任务容易被绕过。
- 默认只监听当前编辑器打开的文件，如果
src/index.ts改了但你正在编辑README.md，不会触发 - 即使配置了
"problemMatcher": ["$tsc"]，也仅影响错误解析，不影响触发时机 - 可靠做法：用插件监听
vscode.workspace.onDidSaveTextDocument，检查document.fileName是否匹配/.(ts|js|json|tsx)$/i，再手动调用executeTask - ⚠️ 避免高频触发：加防抖（debounce 300ms），并跳过临时文件（如
*.tmp、~$*）和 node_modules 下的变更
真正稳定的联动，从来不是靠“让插件去跑 tasks.json”，而是用插件接管任务生命周期：从触发判断、环境准备、命令组装，到结果消费。很多团队卡在 problemMatcher 不生效或保存不触发，其实根源是混淆了“声明式配置”和“运行时控制”的边界。
