VSCode的REST Client插件支持在编辑器内直接测试API:安装插件后,新建.http文件编写类cURL请求,可执行并查看响应;支持添加请求头、认证信息、变量复用及环境配置。

如果您希望在不离开代码编辑器的情况下完成API测试,VSCode的REST Client插件提供了一种无需切换到独立工具即可发送HTTP请求的高效方式。以下是使用该插件进行API调试的具体操作路径:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装REST Client插件
该插件需通过VSCode扩展市场获取并启用,安装后即可直接解析以 .http 或 .rest 为后缀的文件内容,实现内联请求执行。
1、打开VSCode,点击左侧活动栏中的扩展图标(或按快捷键 Cmd+Shift+X)。
2、在搜索框中输入 REST Client,找到由 Huachao Mao 发布的官方插件。
3、点击“安装”按钮,安装完成后点击“重新加载”使插件生效。
二、编写并执行HTTP请求
REST Client支持在纯文本文件中以类cURL语法描述请求,通过右键菜单或快捷键触发执行,响应结果将直接显示在内置预览窗口中。
1、在工作区中新建一个文件,命名为 api.test.http。
2、在文件中输入以下内容:
GET https://jsonplaceholder.typicode.com/posts/1
3、将光标置于该请求行任意位置,按下 Cmd+Alt+R(macOS)或右键选择“Send Request”。
4、下方将弹出响应面板,显示状态码、响应头及JSON格式化后的响应体。
三、配置请求头与认证信息
插件支持在请求前添加自定义Headers和Authorization字段,便于测试需要身份验证的接口。
1、在 .http 文件中,于请求行下方空一行后添加请求头,例如:
GET https://api.example.com/data
Content-Type: application/json
Authorization: Bearer your-access-token-here
2、确保每行Header以英文冒号分隔键值,且冒号后保留一个空格。
3、再次执行请求,插件会自动携带这些Header发送至目标服务器。
四、复用变量与环境配置
通过定义变量可避免硬编码敏感值或重复路径,提升多环境测试效率。
1、在文件顶部添加变量块,格式为 @变量名 = 值:
@host = https://jsonplaceholder.typicode.com
@postId = 1
2、在后续请求中引用变量,写法为 {{变量名}}:
GET {{host}}/posts/{{postId}}
3、变量支持跨文件复用,只需将变量定义保存在单独的 env.http 文件中,并在当前文件首行添加 # @include env.http。










