VSCode中的REST Client：告别Postman，轻松调试API_网络技术

发布时间 - 2026-01-11 00:00:00 点击率：次

可在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发布的官方扩展，点击“安装”按钮。

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，支持会话保持。