可在VSCode中通过REST Client扩展直接调试API接口:安装扩展→创建.api.test.http文件→编写HTTP请求→右键“Send Request”或Cmd+Alt+R发送→配置.rest-client环境变量→用###分隔多请求→自动格式化JSON响应并支持Cookie会话。

如果您希望在VSCode中直接调试API接口,而无需切换到Postman等外部工具,则可以利用REST Client扩展实现高效、轻量的HTTP请求测试。以下是启用并使用该功能的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装REST Client扩展
REST Client是VSCode官方市场中广受认可的轻量级HTTP客户端插件,支持语法高亮、环境变量、请求历史等功能,安装后即可在编辑器内直接发送HTTP请求。
1、打开VSCode,点击左侧活动栏中的扩展图标(或使用快捷键Ctrl+Shift+X)。
2、在扩展搜索框中输入REST Client。
3、在搜索结果中找到由Huachao Mao发布的官方扩展,点击“安装”按钮。
二、创建并运行HTTP请求文件
REST Client通过识别以.http或.rest为后缀的文件来执行请求,文件内按特定语法编写请求内容,保存后可一键发送。
1、在VSCode工作区中新建一个文件,命名为api.test.http。
2、在文件中输入标准HTTP请求格式,例如:
GET https://jsonplaceholder.typicode.com/posts/1
Content-Type: application/json
3、将光标置于请求体任意位置,右键选择“Send Request”,或使用快捷键Cmd+Alt+R(macOS)。
三、配置环境变量简化多环境测试
通过定义环境变量,可避免在不同开发、测试、生产环境间手动修改URL和认证信息,提升调试复用性与安全性。
1、在项目根目录下新建文件.rest-client(注意开头为点号)。
2、在该文件中写入环境配置块,例如:
@host = https://api.example.com
@token = Bearer abc123
3、在.http文件中引用变量,如:
GET {{host}}/users
Authorization: {{token}}
四、使用请求片段与多请求组织
单个.http文件可包含多个独立请求,通过空行分隔,并支持注释与命名分组,便于管理复杂接口调用链。
1、在.http文件中用###分隔不同请求。
2、在每个请求前添加注释说明用途,例如:
# 获取用户列表
GET https://api.example.com/users
3、在请求之间插入空行,确保REST Client能正确识别各请求边界。
五、查看响应与自动格式化
发送请求后,REST Client会在新标签页中展示原始响应内容,并根据响应头中的Content-Type自动进行JSON、XML或HTML格式化渲染,便于快速验证数据结构与状态码。
1、响应标签页默认显示Status Code、响应头及响应体。
2、若响应体为JSON且格式混乱,点击右上角Format Response按钮可自动美化缩进。
3、响应头中出现Set-Cookie时,后续请求将自动携带该Cookie,支持会话保持。










