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 根本没把测试命令注册进命令系统。不是插件坏了，是你环境没搭通。
- 终端里手动执行一次底层命令，确认能跑通：
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 多根工作区，要么统一把配置上提到顶层，并在适配器设置中明确指定路径。
