Test Explorer 点击“Run Test”后实际执行后台构造的终端命令，如 npx jest --runInBand --testNamePattern="should validate email"，命令有效性决定运行结果。
VSCode 的 Test Explorer 本身不运行测试，它只是个 UI 层——真正干活的是你项目里装的测试框架（比如 jest、pytest、go test）和配套的适配器插件。点不动、没反应、跑错范围，八成不是 UI 问题，而是底层命令没拼对或框架不支持。
Test Explorer 点击“Run Test”后实际执行什么命令？
插件点击后，会在后台构造并执行一条终端命令。这条命令是否有效，直接决定你看到的是绿色对勾还是卡在 “Running…”。
- 打开 VSCode 的 Output 面板 → 切到 “Testing” 标签页，就能看到真实发出的命令，例如：
npx jest --runInBand --testNamePattern="should validate email" - 如果命令里含
--testNamePattern却报Unknown option，说明你用的 Jest 版本 - 命令一闪而过没输出？大概率是
jest.pathToJest或python.testing.pytestPath指向了不存在的路径，或者环境变量（如NODE_OPTIONS）没透传给插件进程
为什么单个 it / test 点不了，总是跑整个文件？
这不是插件功能缺失，而是测试框架本身不支持按行粒度识别用例，或者配置没让插件“看懂”那个 it 是独立单元。
- Jest 要求
testMatch正确匹配到含it的文件，比如：["**/?(*.)+(spec|test).[jt]s?(x)"]；若用了testRegex，会与testMatch冲突，优先级更低 - Vitest 用户必须用
pyfisch.vitest-explorer插件，vscode-jest对 Vitest 无效 - 动态生成测试（如
it.each）或嵌套过深的describe，可能导致插件无法准确定位到某一行 —— 此时命令里传的--testNamePattern实际匹配不到任何用例，就退化成跑全文件 - 确保测试函数名是字符串字面量（
it("loads data", ...)），而非变量或模板字符串，否则框架无法静态提取名称
测试不显示在侧边栏？先确认这三件事
Test Explorer 不会主动扫描子目录或非标准路径，它只信任工作区根 + 明确声明的配置。
- 检查 VSCode 当前打开的是**单文件夹工作区**，且该文件夹下有
jest.config.js、pyproject.toml或go.mod等框架识别文件；多根工作区需手动指定每个根的测试适配器 - Python 项目中，
tests/目录必须能被 Python 解释器 import 到（即在PYTHONPATH中，或与setup.py同级），否则python-test-explorer发现不了测试文件 - JavaScript 项目若把
jest.config.js放在packages/foo/下，但 VSCode 打开的是仓库根目录，插件默认不会向下递归查找 —— 要么移配置到根，要么用jest.pathToJest指向npx jest --config packages/foo/jest.config.js
最常被忽略的一点：插件从不“猜”你用什么框架。它只读配置文件、调命令、解析输出。如果你删了 jest.config.js 又没重装依赖，或者 pytest 没进 PATH，Test Explorer 就是空的——它连“该问谁”都不知道。
