Task Explorer 扩展通过侧边栏树状结构统一管理 tasks.json 中的任务,支持一键运行、禁用、编辑与多维过滤;需先安装扩展、配置 tasks.json、手动启用侧边栏,再利用右键菜单和搜索框高效操作。

如果您在使用 VSCode 进行开发时,面对大量自定义任务(如构建、测试、格式化、部署等)感到难以追踪和快速执行,则可能是由于任务缺乏统一的可视化入口。Task Explorer 扩展正是为此设计,它将 tasks.json 中定义的任务以树状结构呈现于侧边栏,支持一键运行、禁用、编辑与过滤。以下是启用并高效使用该扩展的具体操作步骤:
本文运行环境:MacBook Pro,macOS Sequoia。
一、安装 Task Explorer 扩展
Task Explorer 是一个第三方 Visual Studio Code 扩展,需通过扩展市场手动安装,安装后无需重启即可生效,但需确保工作区已配置至少一个 task 才能显示内容。
1、打开 VSCode,点击左侧活动栏最下方的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入 Task Explorer,找到作者为 spmeesseman 的扩展。
3、点击“安装”按钮,等待状态变为“已安装”。
二、配置基础任务以触发 Explorer 显示
Task Explorer 默认只显示当前工作区中 .vscode/tasks.json 文件内定义的有效任务,若该文件不存在或为空,侧边栏将保持空白;因此需先创建一个最小可用任务作为初始支撑。
1、在项目根目录下创建 .vscode 文件夹(若不存在)。
2、在该文件夹中新建文件 tasks.json,内容如下:
3、粘贴以下 JSON 内容并保存:
{
"version": "2.0.0",
"tasks": [
{
"label": "echo hello",
"type": "shell",
"command": "echo 'Hello from Task Explorer!'",
"group": "build"
}
]
}
三、启用并定位 Task Explorer 侧边栏
安装完成且 tasks.json 存在后,Task Explorer 不会自动显示,需手动调出侧边栏视图,其图标位于活动栏底部倒数第二个位置,形状为两个重叠的齿轮。
1、点击活动栏底部的 齿轮叠加图标(即 Task Explorer 图标)。
2、若首次启用,VSCode 可能提示“找不到 Task Explorer 视图”,此时请确认已正确安装扩展并保存了 tasks.json。
3、成功加载后,侧边栏将显示分组任务树,例如 build 分组下展开可见 echo hello 任务项。
四、通过右键菜单执行高级操作
Task Explorer 支持对每个任务节点进行上下文操作,右键点击任一任务可调出快捷菜单,覆盖运行、调试、编辑、禁用、复制标签等常用功能,避免频繁切换到 tasks.json 手动修改。
1、在侧边栏中右键点击 echo hello 任务项。
2、从弹出菜单中选择 Run Task,终端将立即执行对应命令并输出结果。
3、再次右键该任务,选择 Disable Task,该任务将变灰且不可执行,同时 tasks.json 中对应任务的 "enabled": false 字段被自动添加。
五、按类型与标签筛选任务列表
当工作区任务数量增多时,Task Explorer 提供顶部搜索框与分组折叠功能,支持按 label、group、type 等字段实时过滤,帮助聚焦目标任务,减少视觉干扰。
1、在 Task Explorer 侧边栏顶部找到放大镜图标旁的输入框。
2、输入 hello,列表将仅保留 label 中含该字符串的任务。
3、点击分组名称(如 build)左侧的箭头图标,可折叠/展开该组全部子任务。










