VSCode调试测试无反应、断点不生效、Run Test灰显，根本原因是Vitest进程未正确attach或配置/运行环境错位：需确保vitest.config.ts存在且有效、本地安装vitest、测试文件路径被testMatch/include覆盖、启用Testing API；断点生效须加--no-file-parallelism参数禁用并行；Vue/React测试需注册对应插件，Vite alias不可指向未编译源码以防source map断裂。
VSCode 里点“调试测试”没反应、断点不生效、Run Test 按钮灰掉——根本不是插件没装对，而是 Vitest 进程没被正确 attach，或者配置和运行环境错位了。
为什么点击“调试测试”图标没反应？
这不是 VSCode 的锅，是 Vitest 没启动成功或没暴露调试端口。常见原因有：
-
vitest.config.ts文件缺失或导出无效（哪怕只写export default {};也比没有强） - 本地没装
vitest（npm install --save-dev vitest），全局安装的vitest对 VSCode 测试适配器完全不可见 - 项目根目录下没有识别为测试文件的
.test.ts或.spec.ts，且testMatch或include没覆盖到你的路径（比如你把测试放在src/__tests__/，但默认只扫**/*.test.ts） - VSCode 没启用 Testing API：按
Ctrl+Shift+P→ 输入Testing: Enable Testing→ 回车确认
如何让断点在测试里真正停下来？
Vitest 默认以 worker 方式并行跑测试，而 VSCode 的调试器只能 attach 到主进程。不关并行，断点大概率跳过或直接忽略。
- 必须加
--no-file-parallelism参数，确保单线程执行：在终端用vitest --no-file-parallelism --test-timeout=0手动跑一次，看是否能断住 - VSCode 内置调试需走
JavaScript Debug Terminal：打开终端（Ctrl+`），右上角下拉选它，再运行上面那条命令 - 不要依赖“右键 → Debug Test”，它背后可能没传参；优先用终端 + 手动命令验证逻辑通路
- 若你在
.test.ts里写了顶层 JSX 或用了defineComponent，却没配@vitejs/plugin-vue或@vitejs/plugin-react，会直接报ReferenceError，根本进不到断点
Vitest Test Explorer 插件为什么识别不出测试？
这个插件只是 UI 层，它读的是 vitest.config.ts 里的 testMatch 和 include，不是自己猜路径。
- 别混用
testMatch和include：testMatch是第一道筛选（哪些文件算“测试”），include是第二道（从已匹配的文件里再过滤） - 示例：测试文件在
src/__tests__/Button.test.ts，就该配testMatch: ['**/__tests__/**/*.test.ts'] - 改完配置后，VSCode 不自动重载——关掉测试侧边栏，再点左侧试管图标重新打开；或
Ctrl+Shift+P→Vitest: Restart Server - Windows 下路径写
/或\都行，Vitest 内部已 normalize，不用转义
Vue/React 组件测试调试失败，Cannot find module 'vue' 怎么办？
这不是模块没装，是 Vitest 启动时没加载框架 runtime。只配 environment: 'jsdom' 是不够的。
- Vue 项目必须在
vitest.config.ts中引入并注册插件：import vue from '@vitejs/plugin-vue'; plugins: [vue()] - React 项目同理：
import react from '@vitejs/plugin-react'; plugins: [react()]，否则 JSX 解析失败，顶层 JSX 直接抛ReferenceError - 如果用了
setupFiles（比如引入vitest-dom），确保路径存在，且该文件本身不依赖未 resolve 的模块（例如不能在setupFiles里直接import { mount } from '@vue/test-utils'而不配 alias）
最常被忽略的一点：Vitest 的调试能力高度依赖 Vite 生态链路完整。一旦 vite.config.ts 里 alias 指向了未经编译的 node_modules/src，source map 就断了，断点会停在编译后代码上，而不是你写的 .vue 或 .ts 里。
