VS Code 通过 REST Client 扩展实现轻量 API 测试:安装后新建 .http 文件,三行写 GET 请求(方法+URL、空行、空 body),支持 Header、Query、Bearer Token 及变量复用响应数据。

VS Code 本身不内置 API 测试功能,但装上 REST Client 扩展后,就能直接在编辑器里写请求、发调用、看响应,不用切到 Postman 或 curl —— 关键是它轻量、文件即测试用例、支持环境变量和 token 自动注入。
怎么安装 REST Client 扩展
打开 VS Code,点击左侧扩展图标(或按 Ctrl+Shift+X),搜索 REST Client,认准作者是 Huachao Mao 的那个(下载量最高、持续维护)。点击“Install”即可。装完无需重启,新建一个以 .http 或 .rest 为后缀的文件(比如 api.test.http),VS Code 就会自动启用语法高亮和发送按钮。
怎么写一个最简 GET 请求
在 .http 文件里,用三行就能完成一次请求:第一行是方法 + URL,第二行空着,第三行开始是请求体(GET 没有 body,就留空)。VS Code 会在请求上方显示绿色 “Send Request” 链接,点它即可执行。
GET https://jsonplaceholder.typicode.com/posts/1
注意:GET 和 URL 必须在同一行;URL 后不能带多余空格;空行必须存在(否则解析失败);响应会直接在右侧新标签页中显示,含状态码、headers 和 body。
怎么加 Header、Query 参数和认证
Header 写在 URL 下方,每行一个 Key: Value;Query 参数直接拼在 URL 后面;Bearer Token 可用 Authorization: Bearer ,也可以用变量避免硬编码。
-
Content-Type: application/json要显式写,否则默认是text/plain - Query 参数示例:
GET https://api.example.com/users?id=123&name=test(注意&是 URL 中的字面量,不是 HTML 实体) - Token 存在变量里更安全:
@token = eyJhbGciOi...,然后在请求里写Authorization: Bearer {{token}}
变量定义需放在文件顶部,用 @变量名 = 值 格式,且必须以 @ 开头、单独成行。
怎么复用响应数据做后续请求
REST Client 支持用 {{response.body.$.id}} 这类语法提取前一个响应的 JSON 字段,但前提是上一个请求已成功执行,并且你手动点了“Save Response”(右上角小磁盘图标)—— 否则变量为空。常见坑:
- 提取路径用的是
$.key(JSONPath 简写),不是 JS 对象访问语法response.body.key - 嵌套字段要写全,比如
{{response.body.user.profile.email}} - 如果响应是数组,
{{response.body.[0].id}}才能取第一个元素 - 变量只在当前文件内有效,跨文件要用
@import引入公共变量文件
实际调试时,建议先手动复制粘贴关键字段验证逻辑,再上变量提取——毕竟响应结构稍有变化,提取表达式就失效,错误还不报在编辑器里,只在发送后显示空值。










