VSCode测试功能依赖本地Node环境中的Jest命令；必须先确保npx jest在终端可执行且版本正确，再配置testMatch、--runInBand调试参数及Output面板排查命令失败原因。
VSCode 本身不运行测试，它只是调用你本地 Node 环境里的测试命令；如果 npx jest 或 npm test 在终端里跑不通，VSCode 测试面板就一定没反应。
确认 Jest（或你选的框架）能在终端直接执行
这是所有后续操作的前提。VSCode 插件（比如 orta.vscode-jest 或内置 Test Explorer）不会帮你装 Jest，也不会自动 fallback 到全局安装。
- 在项目根目录打开集成终端，运行
npx jest --version—— 必须输出版本号（如29.7.0），否则插件根本找不到可执行入口 - 如果报
command not found: jest，说明jest没装进node_modules/.bin/：执行npm install --save-dev jest @types/jest - 别用
npm install -g jest—— 全局安装的路径通常不被 VSCode 测试适配器识别，容易版本错乱 - 用 pnpm？改用
pnpx jest --version；用 yarn？用yarn jest --version
配置 jest.config.js 让测试文件能被发现
VSCode 测试面板靠 testMatch 或 testRegex 扫描文件。默认规则只认 **/__tests__/** 和 **/*.test.[jt]s，你的命名习惯很可能不匹配。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 如果你的测试文件是
src/utils/format.spec.ts，加一条："**/*.spec.{js,ts}" - 如果你把测试全放在
tests/目录下，改成："<rootdir>/tests/**/*.{test,spec}.{js,ts}" - 别同时写
testMatch和testRegex—— 前者优先级更高，后者会被忽略 - 运行
npx jest --listTests验证是否真能列出来；如果没输出，说明配置没生效
调试单个测试时必须加 --runInBand
Jest 默认多进程并行执行，而 VSCode 的 Node.js 调试器只能 attach 到主进程。不加这个参数，断点基本不会触发，或者只在某个子进程里静默停住。
- 在
launch.json里配置调试任务时，args字段必须包含：--runInBand - 如果用 Test Explorer 点单个
it运行却执行了整个describe块，大概率是框架版本太低（Jest < 28）或没传--testNamePattern - 检查 Output → Testing 面板里实际发出的命令，确认是否带了
--testNamePattern="xxx"；如果报Unknown option: --testNamePattern，升级 Jest 到 28+
VSCode 测试面板没反应？先看 Output → Testing 输出
点击 “Run Test” 卡在 “Running…” 不是插件坏了，而是底层命令静默失败。VSCode 实际拼的是类似 npx jest --testNamePattern="should handle null" 这样的命令。
- 打开 Output 面板 → 切到 “Testing” 标签页，直接看真实命令和报错
- 常见错误：
Cannot find module 'jest'（没装）、Cannot find file xxx.test.ts（testMatch配错）、command 'testExplorer.run' not found（适配器没加载，常因 jest 没识别到） - 终端一闪而过？可能是
jest.pathToJest指向了全局 jest，改成"./node_modules/.bin/jest"或留空让 VSCode 自动找 - Python 用户注意：
python.testing.cwd必须显式设为代码根目录，否则from src.xxx import yyy会报ModuleNotFoundError
真正卡住人的地方往往不是语法或逻辑，而是 VSCode 没法把“你写的测试”和“它调用的命令”对上号——路径、命名、进程模型、工作目录，每个环节都可能断开。先让 npx jest 在终端里稳稳跑起来，再谈 UI 和调试。
