VSCode REST Client 插件可在编辑器内直接发送 HTTP 请求，支持多环境变量、多种认证方式，并能生成可读性强的 API 文档。通过创建 .http 文件编写请求示例，结合 rest-client.environment.json 管理不同环境变量，实现快速接口测试与团队协作。
VSCode REST Client 是一款轻量但功能强大的插件，允许开发者直接在 Visual Studio Code 中发送 HTTP 请求、测试 API 并生成清晰的接口文档。无需切换到 Postman 或其他外部工具，就能完成常见的接口调试任务，提升开发效率。
安装与基本使用
在 VSCode 扩展市场中搜索 “REST Client” 并安装由 Huachao Mao 提供的插件。安装完成后，创建一个以 .http 或 .rest 为后缀的文件（例如 api.test.http）。
在文件中编写请求示例如下：
GET https://jsonplaceholder.typicode.com/posts/1 Accept: application/json
写完后，点击请求上方出现的 Send Request 链接，即可在右侧新标签页中查看响应结果，包括状态码、响应头和返回的 JSON 数据。
组织多环境与变量管理
REST Client 支持环境变量，适合管理开发、测试、生产等不同环境的 API 地址。
创建一个 rest-client.environment.json 文件，内容如下：
{
"dev": {
"apiUrl": "https://dev.api.com"
},
"prod": {
"apiUrl": "https://api.com"
}
}
然后在 .http 文件中使用变量：
GET {{apiUrl}}/users
Accept: application/json
通过 VSCode 状态栏切换当前环境，请求会自动替换对应变量值。
支持多种请求类型与认证方式
你可以轻松测试 POST、PUT、DELETE 等方法，并携带请求体或认证信息。
示例：发送 JSON 数据并带 Bearer 认证
POST {{apiUrl}}/login
Content-Type: application/json
Authorization: Bearer your-token-here
{
"username": "test",
"password": "123456"
}
也支持 OAuth、Basic Auth 等常见方式，只需按标准格式填写 Header 即可。
生成可读性强的 API 文档
将多个请求整理在一个 .http 文件中，可以作为团队共享的 API 文档。
通过注释分组说明用途：
# ------------------------------------ # 用户管理接口 # ------------------------------------获取用户列表
GET {{apiUrl}}/users Accept: application/json
创建新用户
POST {{apiUrl}}/users Content-Type: application/json
{ "name": "张三", "email": "zhangsan@example.com" }
团队成员打开该文件，点击“Send Request”即可立即测试，无需额外配置。结合 Git 提交记录，还能追踪接口变更。
基本上就这些。VSCode REST Client 把测试和文档融合得自然简洁，特别适合轻量级项目或前后端联调场景。不复杂但容易忽略的小工具，用好了能省不少时间。
