Test Explorer UI 扩展提供集中化测试管理视图，需安装主扩展及对应框架适配器，配置启动参数，通过树形界面执行测试，并启用自动发现与实时同步以确保测试状态准确。
如果您在 VSCode 中使用多个测试框架，但缺乏统一的界面来查看和执行测试用例，则 Test Explorer UI 扩展可提供集中化的测试管理视图。以下是启用并使用该扩展的关键操作路径：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 Test Explorer UI 及对应适配器
Test Explorer UI 本身不直接运行测试，需配合特定测试框架的适配器（如 Jest、Mocha、Python pytest 等）才能识别和执行测试。安装主扩展后，必须根据项目所用框架选择并安装匹配的适配器。
1、打开 VSCode，点击左侧活动栏中的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Test Explorer UI，找到由 hbenl 发布的官方扩展并点击安装。
3、再次搜索对应框架名称，例如 jest-test-adapter 或 python-test-explorer，确保安装版本与当前项目依赖兼容。
4、重启 VSCode，使扩展完全加载。
二、配置测试适配器启动参数
适配器需明确知道如何定位和启动测试脚本，因此必须在工作区设置中指定命令路径或配置文件位置。未正确配置将导致测试列表为空或状态始终为“未初始化”。
1、在项目根目录下创建或编辑 .vscode/settings.json 文件。
2、针对 Jest 项目，添加如下字段："jest.jestCommandLine": "npm run test -- --json --outputFile=.jest-test-results.json"。
3、针对 pytest 项目，添加："python.testing.pytestArgs": ["--json-report", "--json-report-file=report.json"]。
4、保存文件后，点击侧边栏 Test 图标，观察右上角是否出现刷新按钮并自动开始扫描。
三、通过 Test Explorer UI 执行单个或批量测试
测试被识别后，将以树形结构展示在 Test Explorer 面板中，支持逐项触发、按描述过滤及状态标记。所有操作均实时反映在 UI 和终端输出中，无需切换到集成终端手动输入命令。
1、展开测试树，找到目标测试用例或测试套件。
2、将鼠标悬停在某项测试名称上，点击右侧出现的 ▶ 播放图标 运行该测试。
3、右键点击任意测试节点，选择 Run All Tests 或 Debug Tests 启动完整流程。
4、运行结束后，测试项旁将显示绿色对勾（通过）、红色叉号（失败）或黄色感叹号（跳过）。
四、启用测试自动发现与实时同步
默认情况下，Test Explorer UI 不会监听文件变更，新增或重命名测试文件后需手动刷新。启用自动发现后，保存测试相关文件时将触发后台重新扫描，确保 UI 始终与代码状态一致。
1、打开 VSCode 设置（Cmd+,），切换至“工作区”标签页。
2、搜索关键词 test explorer auto detect。
3、勾选 Test Explorer > Auto Detect: Enabled 选项。
4、确认项目中 package.json 的 scripts 字段包含有效的 test 命令，例如 "test": "jest"。
五、排查测试未显示问题
当 Test Explorer 面板为空或持续显示“Loading…”时，常见原因包括适配器未激活、测试命令路径错误、权限不足或项目结构不符合框架约定。逐一验证以下环节可快速定位阻塞点。
1、检查 VSCode 输出面板（Ctrl+Shift+U），切换至 Test Explorer 或对应适配器通道，查看初始化日志是否有 ERROR 行。
2、在终端中手动执行适配器所调用的测试命令，确认其能正常生成 JSON 格式结果。
3、验证项目根目录是否存在适配器预期的配置文件，例如 Jest 要求 jest.config.js 或 package.json 中含 jest 字段。
4、若使用 TypeScript，确保 ts-node 已全局安装或已配置于适配器启动参数中。
