Thunder Client 是 VSCode 原生轻量 API 测试工具，支持零配置请求发送、环境变量管理、请求保存至工作区及 JSONPath/状态码断言验证。
如果您正在寻找一款轻量级、集成度高的 API 测试工具，并希望直接在 VSCode 环境中完成请求构建与响应分析，则 Thunder Client 是一个高度适配的选择。它是 VSCode 的原生扩展，无需脱离编辑器即可发起 HTTP 请求、管理环境变量、保存请求历史并进行基础断言验证。
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Thunder Client 扩展
Thunder Client 作为 VSCode 扩展，需通过扩展市场安装，其核心优势在于零配置启动和与工作区的深度绑定。安装后即可立即创建首个请求，无需额外服务进程或账户注册。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X / Cmd+Shift+X）。
2、在搜索框中输入 Thunder Client，找到由 Rajeshwaran K 发布的官方扩展。
3、点击“安装”按钮，安装完成后点击“重新加载”或重启 VSCode。
二、创建并发送第一个 HTTP 请求
Thunder Client 提供树状请求组织结构，支持文件夹分组与请求复用。新建请求时自动继承当前工作区的环境配置，便于多环境切换测试。
1、点击 VSCode 右侧边栏的 Thunder Client 图标（闪电图标）。
2、点击顶部的 + New Request 按钮。
3、在弹出的编辑区域中，选择请求方法（如 GET），在 URL 栏输入 https://httpbin.org/get。
4、点击右上角的 Send 按钮，右侧将显示响应状态码、Headers 和响应体。
三、配置并切换环境变量
Thunder Client 支持 JSON 格式的环境定义，可为不同部署环境（如开发、测试、生产）预设 host、token、端口等变量，避免硬编码和手动替换。
1、点击 Thunder Client 边栏右上角的齿轮图标，选择 Manage Environments。
2、点击 + Add Environment，输入环境名称（如 dev）。
3、在变量区域添加键值对，例如：base_url: https://api.dev.example.com。
4、在请求 URL 中使用 {{base_url}}/users，点击环境下拉菜单即可实时切换。
四、保存请求至项目工作区
Thunder Client 将请求数据以 JSON 文件形式保存在 .vscode/thunder-client/ 目录下，该路径被纳入 Git 忽略默认规则，但可手动调整以实现团队共享请求集合。
1、在请求编辑页点击右上角三个点菜单，选择 Save Request。
2、在弹出的文件选择器中，导航至项目根目录下的 .vscode/thunder-client/ 文件夹（若不存在则自动创建）。
3、输入文件名（如 get-user.json），确认保存。
4、该请求将出现在 Thunder Client 边栏的“Saved Requests”节点下，且随项目 Git 仓库一同提交（需取消 .gitignore 中对应路径忽略）。
五、添加简单响应断言
Thunder Client 支持基于 JSONPath 和状态码的轻量断言，用于快速验证接口行为是否符合预期，适用于本地调试与 CI 前置检查。
1、发送一次请求后，在响应面板下方点击 Add Assertion 按钮。
2、在条件类型中选择 Status Code，输入期望值 200。
3、如需校验响应字段，选择 JSON Path，输入路径 $.status，期望值填 success。
4、再次发送请求，断言结果将以绿色（通过）或红色（失败）标签显示在响应头部。
