VSCode测试功能默认完全不可用，需手动安装框架、配置文件并启用Testing API；缺任一条件则“Run Test”按钮灰色或消失，本质是未触发测试发现流程。
VSCode 无配置纯净版启动时，测试功能默认完全不可用——它不自带任何测试框架、不预装适配器、不识别任何测试文件。所谓“能点 Run Test”，全是靠你手动补全的环境和配置。
为什么点“Run Test”按钮是灰色或直接消失
VSCode 启动后不会自动扫描项目、不会猜你用 Jest 还是 Vitest、也不会去读 package.json。测试视图（烧杯图标）只有在满足全部以下条件时才激活：
- 已安装对应语言扩展（如 Python 扩展、Jest Runner 或 Test Explorer UI）
- 工作区根目录存在可识别的测试入口文件（如
jest.config.js、vitest.config.ts、pyproject.toml中含[tool.pytest]） - 终端中能直接执行对应命令（如
pytest --version或npx vitest --version） - VSCode 设置里已启用 Testing API：
Testing: Enabled为true
缺任意一项，测试侧边栏就不显示，或按钮灰掉。不是插件坏了，是 VSCode 根本没触发测试发现流程。
不改 settings.json、不装插件，也能临时跑一次测试
适用于快速验证逻辑、没有时间配环境的场景。本质是绕过测试面板，直连终端命令：
- 打开测试文件（如
test_add.py或sum.test.ts） - 按
Ctrl+`呼出集成终端 - 手动运行框架命令：
pytest test_add.py -s、npx vitest run sum.test.ts、npx jest --testNamePattern="should add" - 若报
command not found，说明框架未本地安装，此时npm install --save-dev vitest或pip install pytest是唯一解法
这个方法不依赖任何配置，但无法设断点、看不到树状结构、也不能右键单测——它只是“跑命令”，不是“启动测试会话”。
Minimal 配置让测试面板亮起来（三行生效）
不需要 tasks.json、不需要 launch.json、不需要插件冲突排查。只要三处最小改动，VSCode 就能识别并列出测试：
- 确保项目已安装测试框架：
npm install --save-dev vitest或pip install pytest - 在项目根目录放一个最简配置文件：
vitest.config.ts内容仅一行：export default {};；或pyproject.toml中加：[tool.pytest] - 按
Ctrl+Shift+P→ 输入Testing: Enable Testing→ 回车（这步必须手动触发，纯净启动默认关闭）
做完立刻刷新测试侧边栏——如果仍不显示，打开 Output 面板 → 切到 Testing 标签页，看第一行是否出现 “Started watching for test changes” 或类似日志。没有就说明框架命令根本没调起来，问题一定出在 PATH 或本地安装上。
调试断点失效的隐藏开关：--no-file-parallelism
Vitest 默认开多进程并行跑测试，Jest 默认用 worker 线程池——这两者都会导致 VSCode 调试器 attach 失败，断点变空心、console.log 不输出、debugger 被跳过。
- 对 Vitest：必须加
--no-file-parallelism参数，无论是命令行还是 launch.json 的args字段 - 对 Jest：必须加
--runInBand，否则断点只在主进程有效，worker 里的测试完全不响应 - Python + pytest：需加
--capture=no（等价于-s）才能看到 print 输出，否则全被 pytest 拦截
这个参数不是可选项，是调试前提。很多人卡在“点了 Debug Test 没反应”，其实只是少传了一个 flag。
