vscode 的 REST Client 插件支持轻量高效 API 调试,无需切换 工具;支持 .http/.rest 文件编写请求、快捷键发送、变量与多环境管理、链式请求及响应提取,并可版本化集成到开发流程中。

VSCode 的 REST Client 插件确实能帮你轻量、高效地完成 API 调试,不用切出编辑器,也不用额外开 postman —— 关键是写法简洁、环境管理清晰、还能和代码工程一起版本化。
安装与基础用法
在 VSCode 扩展市场搜 REST Client(作者:Huachao Mao),一键安装。新建一个 .http 或 .rest 文件(比如 api.test.http),直接写请求:
GET https://jsonplaceholder.typicode.com/posts/1POST https://jsonplaceholder.typicode.com/postsContent-Type: application/json{"title": "VSCode REST Client","body": "No Postman needed.","userId": 1}
光标放在请求内,按 Ctrl+Alt+R(windows/linux)或 Cmd+Alt+R(mac)即可发送,响应会自动在右侧新标签页中展示。
变量与环境管理
支持定义变量,方便切换开发 / 测试 / 生产环境。在文件顶部加:
@baseUrl = https://api.example.dev@authToken = eyJhbGciOi……
后续请求直接引用:GET {{baseUrl}}/users,Authorization: Bearer {{authToken}}。还可以用 @env 块管理多套环境,配合命令面板(Ctrl+Shift+P → REST Client: switch Environment)快速切换。
链式请求与响应提取
适合需要登录后拿 token 再调其他 接口 的场景。用 ### 分隔不同请求,并用 {{response.body.$.<property>}}</property> 提取 JSON 字段:
POST https://api.example.com/loginContent-Type: application/json{"email": "user@example.com", "password": "123" }###GET https://api.example.com/profileAuthorization: Bearer {{response.body.$.token}}
第一次运行登录请求后,第二次就能自动复用返回的 token —— 不用手动复制粘贴。
集成进日常开发流
把 .http 文件放在项目根目录或 docs/api/ 下,和接口文档、Mock 数据放一起;提交到 git,团队成员开箱即用。配合 Prettier + REST Client 格式化插件,还能自动对齐 headers 和 body。调试时不用离开代码上下文,改完接口逻辑,顺手在隔壁 tab 点一下就验证结果。
基本上就这些 —— 没有复杂配置,不依赖外部 工具,写得清楚,跑得明白。