任务提供者允许扩展定义自定义任务类型，通过在package.json中声明taskDefinitions并实现TaskProvider接口，使VSCode能识别和运行特定任务；provideTasks返回可选任务列表，resolveTask解析未完全定义的任务，确保动态执行；用户在tasks.json中使用自定义type时需依赖扩展完成实际逻辑，关键在于正确注册任务类型并实现resolveTask以支持自定义任务运行。
vscode 中的任务提供者允许扩展为工作区定义自定义任务，比如构建、测试或部署脚本。通过实现“自定义任务类型”，你可以让 vscode 识别并运行特定格式的任务，而无需依赖默认的 tasks.json 配置文件中的固定结构。
理解任务提供者与自定义任务类型
VSCode 的任务系统基于 Task Provider 机制。当用户运行“运行任务”（Ctrl+P → Task: Run Task）时，VSCode 会查询注册的任务提供者来动态生成可用任务列表。
自定义任务类型指的是你在 package.json 中声明的一种新的 type，然后由你的扩展解析这种类型的 task 定义。
步骤一：在 package.json 中声明任务类型
在扩展的 package.json 的 contributes 字段中注册你支持的任务类型：
"contributes": {
"taskDefinitions": [
{
"type": "mybuild",
"when": "false",
"properties": {
"target": {
"type": "string",
"description": "Build target"
},
"watch": {
"type": "boolean",
"description": "Enable watch mode"
}
}
}
]
}
这里定义了一个名为 mybuild 的任务类型，它有两个属性：target 和 watch。VSCode 将能识别该类型的任务，并进行语法校验。
步骤二：实现 TaskProvider
在扩展主文件（如 extension.ts）中注册一个任务提供者：
import * as vscode from 'vscode';export function activate(context: vscode.ExtensionContext) { context.subscriptions.push( vscode.tasks.registerTaskProvider('mybuild', new MyBuildTaskProvider()) ); }
'mybuild' 是前面定义的任务类型名称。接下来需要实现 MyBuildTaskProvider 类。
Avactis是一个强大的PHP在线购物系统拥有多个版本包括开源版本。它具备一个在线购物系统所需要的所有功能从产品到会员管理，订单和营销。可以无限分类和为产品指定任务数量的图片（支持自动生成缩略图）。使用自定义字段功能，让你可以更好地定义一个产品。该系统提供以非常灵活的方式来创建任意类型的促销活动如设置折扣代码，基于价格的折扣或基于数量的折扣等。
步骤三：编写 MyBuildTaskProvider
这个类需实现 provideTasks 和 resolveTask 方法：
class MyBuildTaskProvider implements vscode.TaskProvider {
async provideTasks(token?: vscode.CancellationToken): Promise {
return [this.createBuildTask(), this.createWatchTask()];
}
resolveTask(task: vscode.Task): vscode.Task | undefined {
// 对于动态任务（非 tasks.json 中预定义），必须实现此方法返回完整任务
const definition = task.definition;
return this.createCustomTask(definition.target, definition.watch);
}
private createBuildTask(): vscode.Task {
const definition: any = {
type: 'mybuild',
target: 'all',
watch: false
};
return new vscode.Task(
definition,
vscode.TaskScope.Workspace,
'Build All',
'mybuild',
new vscode.ProcessExecution('make', ['build'])
);
}
private createWatchTask(): vscode.Task {
const definition: any = {
type: 'mybuild',
target: 'all',
watch: true
};
return new vscode.Task(
definition,
vscode.TaskScope.Workspace,
'Watch Changes',
'mybuild',
new vscode.ProcessExecution('make', ['watch'])
);
}
private createCustomTask(target: string, watch: boolean): vscode.Task {
const kind: any = { type: 'mybuild', target, watch };
const name = watch ? Watch ${target} : Build ${target};
const args = watch ? ['watch', target] : ['build', target];
return new vscode.Task(
kind,
vscode.TaskScope.Workspace,
name,
'mybuild',
new vscode.ProcessExecution('mytool', args)
);
}
}
说明：
-
provideTasks返回静态任务列表，出现在“运行任务”菜单中。 -
resolveTask用于从 tasks.json 中未完全定义的任务创建实际可执行任务，尤其适用于用户自定义任务。 -
ProcessExecution表示以子进程方式运行命令，也可使用ShellExecution。
步骤四：在 tasks.json 中使用自定义任务
用户可以在项目根目录下的 .vscode/tasks.json 中这样写：
{
"version": "2.0.0",
"tasks": [
{
"label": "Custom Build Frontend",
"type": "mybuild",
"target": "frontend",
"watch": false,
"problemMatcher": ["$tsc"]
}
]
}
当用户选择该任务时，VSCode 会调用扩展的 resolveTask 来构造具体执行逻辑。
基本上就这些。通过上述方式，你可以将复杂的构建逻辑封装进扩展，让用户以简洁、类型安全的方式定义任务。关键点在于正确声明任务 schema 并完整实现 TaskProvider 接口。不复杂但容易忽略的是 resolveTask —— 如果缺失，自定义任务将无法运行。
