VSCode的REST Client插件支持在编辑器内直接发起HTTP请求并查看响应。需先安装插件,再创建.http文件编写请求,通过右键或快捷键执行,可配置请求头、体、环境变量,并保存响应至本地。

如果您希望在代码编辑器中直接发起HTTP请求并查看响应,而无需切换到外部工具,则VSCode的REST Client插件可提供轻量、集成度高的API测试能力。以下是启用并使用该插件的具体操作路径:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装REST Client插件
该插件由Huachao Mao开发,是VSCode Marketplace中专为HTTP请求设计的轻量级扩展,支持语法高亮、环境变量、会话保持与响应预览等功能。
1、打开VSCode,点击左侧活动栏的扩展图标(或按快捷键Cmd+Shift+X)。
2、在搜索框中输入REST Client,找到作者为Huachao Mao的官方插件。
3、点击“安装”按钮,等待插件下载并自动启用。
二、创建并执行HTTP请求文件
REST Client通过识别以.http或.rest为后缀的纯文本文件来解析请求,文件内使用类cURL语法书写请求语句,执行时将实时返回响应内容。
1、在当前工作区中新建一个文件,命名为api-test.http。
2、在文件中输入以下内容:
GET https://httpbin.org/get
3、将光标置于该请求行任意位置,右键选择Send Request,或使用快捷键Cmd+Alt+R。
4、下方将自动弹出响应面板,显示状态码、响应头及JSON格式化后的响应体。
三、配置请求头与请求体
插件支持在请求中显式声明Headers和Body,适用于POST、PUT等需携带数据的场景,且能自动识别Content-Type并处理编码。
1、在.http文件中新增一段请求:
POST https://httpbin.org/post
Content-Type: application/json
{
"name": "Alice",
"age": 30
}
2、确保请求头与Body之间有且仅有一行空行。
3、将光标置于POST行,执行Send Request。
4、响应体中的json字段将完整回显提交的数据。
四、使用环境变量管理多套配置
通过定义@name语法声明环境变量,可在不同环境(如dev/staging/prod)间快速切换基础URL、认证令牌等参数,避免硬编码。
1、在文件顶部添加环境块:
@host = https://httpbin.org
@token = abc123
2、在后续请求中引用变量:
GET {{host}}/get
Authorization: Bearer {{token}}
3、保存文件后,所有{{xxx}}占位符将在发送时被对应值替换。
五、保存响应结果至本地文件
插件支持将响应内容导出为JSON、TXT等格式,便于归档或后续比对,尤其适用于接口契约验证场景。
1、执行一次请求,待响应面板出现后,右键点击响应区域。
2、选择Save Response As...。
3、在弹出对话框中指定路径与文件名,例如response-20241105.json。
4、确认保存,文件将以UTF-8编码写入磁盘,保留原始响应结构与缩进。










