Thunder Client 是 VSCode 内置轻量 API 测试工具,支持快速安装、发送请求、保存集合、设置头/参数及环境变量。操作步骤依次为:安装扩展→新建请求→保存至集合→配置 Headers/Params→管理多环境变量。

如果您正在寻找一款轻量、快速且无需额外安装的 API 测试工具,VSCode 内置扩展 Thunder Client 可能正是您需要的替代方案。它直接集成于编辑器中,避免了切换窗口和独立应用启动的延迟。
本文运行环境:MacBook Air,macOS Sequoia。
一、安装并启用 Thunder Client 扩展
Thunder Client 以 VSCode 扩展形式存在,需先通过扩展市场获取并激活,才能在侧边栏中显示其图标并开始使用。
1、打开 VSCode,点击左侧活动栏最下方的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入 Thunder Client,找到由 Rajesh Kumar 发布的官方扩展。
3、点击“安装”按钮,安装完成后点击“重新加载”或重启 VSCode。
4、重新打开后,点击左侧活动栏中新出现的闪电图标,即可进入 Thunder Client 界面。
二、创建并发送第一个 HTTP 请求
Thunder Client 支持快速新建请求,可手动填写 URL、方法类型及参数,所有操作均在单页内完成,无需配置集合或环境即可立即执行。
1、在 Thunder Client 界面点击 + New Request 按钮。
2、在弹出的表单中输入请求 URL,例如 https://httpbin.org/get。
3、从下拉菜单中选择请求方法,如 GET。
4、点击右上角的 Send 按钮,响应结果将直接显示在下方区域。
三、保存请求至项目集合
为便于复用与组织,Thunder Client 允许将单个请求保存到本地集合中,该集合以 JSON 文件形式存储在工作区 .thunder-client/ 目录下,支持跨会话持久化。
1、在请求编辑区右键,选择 Save Request。
2、在弹出的输入框中为请求命名,例如 Test GET。
3、从下拉列表中选择目标集合,若无合适集合,可点击 Create new collection 新建一个。
4、确认后,该请求即被写入 .thunder-client/collections.json 文件,并可在侧边栏集合树中展开查看。
四、添加请求头与查询参数
Thunder Client 提供标签式界面管理不同请求组成部分,Headers 和 Params 标签页分别用于设置 HTTP 头部字段与 URL 查询参数,操作直观且实时生效。
1、在请求编辑区点击顶部的 Headers 标签页。
2、在 Key 列输入 Content-Type,Value 列输入 application/json。
3、切换到 Params 标签页,输入键 q 与值 vscode,系统将自动拼接到 URL 末尾。
4、再次点击 Send,请求将携带所设头部与参数发出。
五、使用环境变量管理多套配置
Thunder Client 支持定义环境变量,可为开发、测试、生产等不同场景分别配置基础 URL、Token 等值,避免硬编码并提升安全性。
1、点击 Thunder Client 顶部工具栏右侧的环境名称(默认为 No Environment)。
2、选择 Manage Environments,点击 + Add Environment。
3、输入环境名如 dev,并在变量列表中添加键 base_url,值为 https://api.dev.example.com。
4、返回请求编辑区,在 URL 中使用 {{base_url}}/users 语法引用该变量,发送时将自动替换。










