test explorer侧边栏不显示测试是因为vscode未识别出可运行的测试，核心原因包括：未安装对应语言的测试适配器、缺少框架必需配置文件、settings.json中禁用自动检测、测试文件路径或命名不符合默认规则、底层工具（如pytest/jest/dotnet）未正确安装或path未配置。

Test Explorer 在 VSCode 里不是“装完就能用”的功能——它只负责画界面，真正干活的是你项目里已安装的测试框架和对应的适配器。没配对底层工具，侧边栏永远是空的或点不动。

为什么 Test Explorer 侧边栏不显示任何测试？

核心原因就一个：VSCode 没识别出你项目里有“可运行的测试”。这不是 UI 问题，而是配置链断裂。

• 没装对应语言的测试适配器（比如 Python 项目漏装 Python Test Explorer for Visual Studio Code，JS/TS 项目只装了 Test Explorer UI 却没装 vscode-jest 或 jest-test-adapter）
• 工作区根目录下缺少测试框架必需的配置文件：pytest 需要能被 pytest --version 命令调通；jest 需要有 package.json 里的 "test" script 或 jest.config.js；dotnet test 需要项目含 .csproj 且 SDK 可用
• settings.json 里误设了 "testing.autoDetect": "off"，或者旧版扩展要求显式开启 "testExplorer.enable": true 但没加
• 测试文件路径不符合默认扫描规则：比如 Python 默认只扫 tests/ 目录或 test_*.py / *_test.py 文件，而你的测试放在 src/tests 却没在 python.testing.pytestArgs 中指定 ["--rootdir=src"]

点了“Run Test”却报 command 'testExplorer.run' not found？

这个错误说明适配器根本没加载成功，VSCode 根本没把测试命令注册进命令系统。不是插件坏了，是你环境没搭通。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 终端里手动执行一次底层命令，确认能跑通：pytest tests/、npx jest --listTests、dotnet test —— 任一失败，Test Explorer 就不可能工作
• 检查 PATH：比如 pytest 是全局安装的，但 VSCode 启动时没继承 shell 的 PATH（macOS/Linux 常见），可尝试从命令行启动 VSCode：code .
• JS/TS 项目中，jest 必须以本地依赖形式存在（即出现在 node_modules/.bin/jest），全局安装的 npm install -g jest 不被大多数适配器识别
• Python 项目若用 conda 环境，确保 VSCode 选对了解释器（右下角 Python 版本提示），且该环境中已运行 pip install pytest

Debug Test 按钮点了没反应，或断点不触发？

调试测试 ≠ 调试普通脚本，它依赖测试框架自身是否支持调试协议，以及 VSCode 是否用对了启动方式。

• Python + pytest：必须在 .vscode/launch.json 中存在有效的 Python: pytest 配置项；断点只能打在测试函数体内，不能打在 conftest.py 的 fixture 里（除非加 --capture=no 参数）
• Jest：需在 launch.json 中配置 "type": "node" 且启用 "autoAttachChildProcesses": true，否则 Babel、TS 编译等子进程里的代码无法停住
• 通用陷阱：终端里 npm test 能跑，但 Debug Test 失败——大概率是环境变量没透传，比如 NODE_OPTIONS=--require ts-node/register 没写进 launch 配置的 env 字段
• Go / .NET 等语言，调试能力取决于对应语言扩展是否实现了 Test Debug Adapter 协议，不是所有插件都支持

最常被忽略的一点：Test Explorer 的行为高度依赖你打开的“工作区根目录”。它不会跨文件夹扫描，也不会读取子目录里的独立配置。如果你的测试分散在多个 package 下（比如 monorepo），要么用 VSCode 多根工作区，要么统一把配置上提到顶层，并在适配器设置中明确指定路径。