VSCode单点运行单个测试用例依赖测试框架原生支持，如Jest≥24用--testNamePattern、Vitest≥0.30用-t、pytest≥6用-k；框架不支持则插件无法实现，需检查版本、插件匹配、配置文件及文件命名规范。
VSCode 里点一下就跑单个 it 或 test 用例，得靠测试框架原生支持
不是插件“加个按钮”就能实现的——VSCode 测试面板（Test Explorer）只是 UI 层，真正执行逻辑、识别单个用例边界的是底层测试框架本身。比如 Jest 能通过 --testNamePattern 过滤单个 it，而 Vitest 用 -t，pytest 用 -k。如果框架不支持按名称粒度运行，插件再 fancy 也点不动单个用例。
常见错误现象：
• 点击某个 it 用例旁的“▶”图标，结果整个文件或整个 describe 块都跑了
• 插件显示“Run Test”，但终端输出提示 Unknown option: --testNamePattern
• 用 jest --watch 手动输名字能跑，但 VSCode 插件里点不动
- 确认你用的测试框架版本是否支持细粒度运行（如 Jest ≥ 24，Vitest ≥ 0.30，pytest ≥ 6）
- 检查插件是否匹配框架：Jest 用
Orta.vscode-jest，Vitest 用pyfisch.vitest-explorer，Python 用ms-python.python自带测试发现 - VSCode 的
settings.json中别写死全局jest.path或python.testing.pytestArgs，否则可能覆盖插件默认参数
配置 jest.config.js 让单个 it 可被正确识别和过滤
Jest 默认只把 describe 和 test/it 当作测试单元，但若用了动态生成（如 it.each）、嵌套 describe 深度过大，或自定义 testMatch，VSCode 插件可能无法准确定位到单个 it 行。
- 确保
testMatch匹配到含it的文件（例如["**/__tests__/**/*.[jt]s?(x)", "**/?(*.)+(spec|test).[jt]s?(x)"]） - 避免在
jest.config.js中设置testRegex和testMatch同时存在，后者优先级更高，容易冲突 - 如果用了
setupFilesAfterEnv加载了全局 mock，确保它不抛错——否则单个用例运行时可能因 setup 失败而静默跳过
VSCode 测试面板点不起来？先看终端命令是不是真发出了
插件点击“Run Test”后，实际是在后台拼一条命令跑。如果没反应，不是插件坏了，大概率是命令构造失败或被拦截。
常见错误现象：
• 点击后测试面板状态一直卡在 “Running…”，终端无任何输出
• 终端闪一下就消失，看不到报错
• 插件报错 Cannot read property 'uri' of undefined
- 打开 VSCode 的“Output”面板 → 切到 “Testing” 标签页，看真实执行的命令（类似
npx jest --runInBand --testNamePattern="should handle login failure" src/auth.test.ts） - 复制这条命令，粘贴进终端手动执行——如果报错，说明是 Jest/Vitest 配置问题；如果成功，说明是插件环境变量或工作区路径问题
- 检查当前打开的文件是否在工作区根目录下：VSCode 测试插件通常以
workspaceFolder为 cwd，若测试文件在子文件夹且未设rootPath，可能找不到配置
Pytest + VSCode：为什么 it 不生效，但 def test_* 可以点
Python 没有 it 语法，这是前端开发者常踩的混淆点。VSCode 的 Python 测试支持只识别 def test_* 或带 @pytest.mark.parametrize 的函数，不会解析类似 Jest 风格的字符串描述。
- 写法必须是
def test_user_can_login():，不是it("user can login", ...) - 如果用了
pytest-describe这类第三方库模拟describe/it，VSCode 默认不识别——它依赖 pytest 原生命名约定，不是 AST 解析器 - 想让单个参数化用例可点，得用
@pytest.mark.parametrize("case", [...], ids=["login_success", "login_fail"])，然后 VSCode 才能按ids过滤
最易被忽略的一点：测试文件名必须以 test_ 开头或以 _test.py 结尾，否则 pytest 根本不扫描，VSCode 测试面板里压根不会出现那个文件——连“点”的机会都没有。
