VSCode需手动配置才能实现单元测试“一键运行”：前提是Node.js全局可用且PATH正确，项目含package.json并定义"test":"jest"脚本，再安装Jest及Test Explorer、Jest Test Explorer插件，三者缺一不可。
VSCode 本身不自带 Node.js 运行时，也**不自动集成单元测试能力**；所谓“一键化”，本质是靠正确配置 package.json 脚本 + 合适的测试框架 + VSCode 的 Test Explorer 插件协同完成——缺一不可，且任意一环出错都会导致“点不动”或“找不到测试”。
确认 node 和 npm 已全局可用
这是所有后续操作的前提。VSCode 的终端（Ctrl+`）必须能直接执行 node -v 和 npm -v 并输出版本号。
- 如果报错
command not found: node，说明系统 PATH 没包含 Node.js 安装路径（Windows 常见于没勾选 “Add to PATH”） - macOS 或 Linux 用户若用
nvm，需确保当前 shell 已加载nvm，且nvm current返回有效版本 - VSCode 启动方式影响环境变量：从桌面图标启动可能不继承 shell 的 PATH，建议从终端执行
code .打开项目
初始化项目并安装 Jest（推荐首选）
Jest 对 TypeScript/JavaScript 支持最成熟，且与 VSCode Test Explorer 集成最稳定。不要跳过 npm init -y 步骤，否则 package.json 缺失会导致插件无法识别测试脚本。
- 运行
npm init -y生成基础package.json - 安装 Jest：
npm install --save-dev jest - 在
package.json中添加脚本："test": "jest" - 创建一个
sum.test.js文件，内容含test()函数，否则 Test Explorer 不会扫描到任何测试
安装并启用 Test Explorer 插件链
仅装 Jest 插件不够，必须组合使用三个核心插件才能实现侧边栏“一键运行”：
-
Test Explorer UI：提供统一测试视图（侧边栏“测试”图标） -
Jest Test Explorer：专为 Jest 设计的适配器，负责发现、运行、解析结果 -
Node.js Extension Pack（可选但推荐）：包含调试、语法、格式化等基础支持，避免零散安装 - 安装后重启 VSCode，打开有
.test.js文件的文件夹，侧边栏应出现“测试”图标，点击后显示测试列表
调试测试时断点不生效？检查 launch.json 类型
VSCode 默认的 Node.js 调试配置（type: "node"）**不能直接用于 Jest 测试调试**。Jest 是通过 node 进程启动的子进程，普通 launch 配置无法 attach。
- 正确做法：在测试文件中右键 →
Debug Test，VSCode 会自动触发jest --runInBand模式，并使用内置的node-terminal调试器 - 若手动配置
launch.json，必须设"type": "node-terminal"或"type": "pwa-node"，且"request": "launch"，指向node_modules/.bin/jest路径 - 常见错误：复制主程序的 launch 配置去跑测试，结果调试器启动但断点灰掉——因为进程没被正确 attach
真正卡住的地方往往不是写测试，而是 VSCode 没“认出”你装的是 Jest，或者 package.json 里没声明 test 脚本。只要这三个条件满足：PATH 正确、package.json 存在且含 test 字段、Test Explorer 插件链已启用，侧边栏里的绿色“运行”按钮就会亮起——其余都是细节微调。
