Thunder Client是VSCode中轻量级API测试工具,支持安装后即用、创建请求、配置头与体、保存至集合、管理环境变量及运行JavaScript测试脚本。

如果您在VSCode中需要快速测试API接口,但又不想启动重量级的Postman或Insomnia,Thunder Client提供了一个嵌入式、无需离开编辑器的替代方案。以下是关于该工具的基本使用与配置说明:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装Thunder Client扩展
Thunder Client作为VSCode Marketplace中的免费扩展,通过VSCode内置扩展管理器即可完成安装,安装后立即集成到侧边栏,无需额外配置即可启动基础请求。
1、打开VSCode,点击左侧活动栏最下方的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入Thunder Client。
3、在搜索结果中找到由RangaVadhineni发布的官方扩展,点击“安装”按钮。
4、安装完成后,点击VSCode左上角“查看”菜单,选择“命令面板”,输入并执行“Thunder Client: Open”。
二、创建并发送第一个HTTP请求
Thunder Client采用类似文件系统的结构组织请求,支持保存为项目内集合,所有操作均在VSCode界面内完成,不依赖外部窗口或进程。
1、点击左侧Thunder Client图标,展开面板。
2、点击面板顶部的+ New Request按钮。
3、在弹出的输入框中填写请求URL,例如https://httpbin.org/get。
4、从方法下拉菜单中选择GET,然后点击右侧的Send按钮。
三、配置请求头与请求体
对于需要认证或提交结构化数据的API,Thunder Client支持手动添加Headers和Body,且自动识别Content-Type以启用对应格式编辑器。
1、在请求编辑区域点击Headers标签页。
2、点击“Add header”行,在Key栏输入Authorization,在Value栏填入Bearer your_token_here。
3、切换至Body标签页,选择raw选项卡,再从右侧下拉菜单中选择JSON。
4、在文本框中输入JSON内容,例如{"name": "test", "value": 123}。
四、保存请求到集合并复用环境变量
Thunder Client支持将请求归类至集合(Collection),并可定义环境(Environment)以管理不同部署环境下的变量,避免硬编码敏感信息。
1、点击请求右上角的Save to Collection图标。
2、在弹出窗口中选择“Create new collection”,命名为“Production API”。
3、点击左侧Thunder Client面板顶部的齿轮图标,选择“Manage Environments”。
4、点击“Add Environment”,输入名称“dev”,在键值对中添加base_url: https://api.dev.example.com。
五、运行测试脚本验证响应
Thunder Client内置JavaScript运行时,允许在响应返回后执行测试脚本,用于断言状态码、字段存在性或数值范围,提升接口回归验证效率。
1、点击请求编辑区底部的Tests标签页。
2、输入以下脚本:pm.test("Status code is 200", function () { pm.response.to.have.status(200); });
3、再次发送请求,查看下方“Tests”结果面板是否显示绿色通过标记。
4、可在同一标签页中添加更多断言,例如检查响应体中某个字段是否包含预期字符串。










