rest client插件需安装huachao mao官方版并保存为.http/.rest后缀;语法严格:方法名大写+空格、header冒号后空格、body前空行且无缩进;变量注入和token提取需正确配置,响应json需手动格式化。

REST Client 插件必须装对、后缀必须写对
VSCode 本身不带 HTTP 客户端能力,REST Client 是唯一被广泛验证、持续维护的轻量方案(作者 Huachao Mao)。装错插件(比如搜到“REST API”“HTTP Request”等名字相近但非官方的)会导致语法不识别、按钮不出现、快捷键无效。
- 在 VSCode 扩展面板搜索
REST Client,认准作者是Huachao Mao,安装后无需重启(2026 年起已支持热加载) - 文件必须保存为
.http或.rest后缀——test.txt或没后缀的文件,哪怕内容完全正确,REST Client也不会激活 - 新建文件后直接输
GET https://httpbin.org/get,保存为demo.http,顶部立刻出现 Send Request 链接,这是插件生效的最简验证
请求语法错一个空格就发不出去
REST Client 解析极严格,不是“差不多就行”。常见失败根本不是网络或服务问题,而是格式被拒:光标悬停在请求行上没反应、右键无菜单、Ctrl+Alt+R 报错 No request found,基本都卡在这几处。
- 方法名必须大写且后跟一个空格:
GET https://...✅,get https://...❌,GEThttps://...❌(缺空格) - Header 冒号后必须有空格:
Content-Type: application/json✅,Content-Type:application/json❌ - Body 必须紧跟空行,且**不能缩进**:
{ "id": 1 }✅,{ "id": 1 }❌(开头空格导致解析失败) - 多个请求用空行分隔,不是
###——那是旧版误传,当前版本只认空行
环境变量和 Token 管理别硬编码
把 Authorization: Bearer xxxxx 直接写死在 .http 文件里,既不安全也难切换环境。插件支持变量注入,但配置路径容易走偏。
- 全局变量定义在
settings.json里:"rest-client.environmentVariables": { "dev": { "baseUrl": "https://api.dev.example.com" } } - 敏感值(如 API key)应存于
.env.json文件(需手动创建),并加进.gitignore;插件会自动读取,变量写法是{{apiKey}} - Token 自动提取链:上一个响应里用
@accessToken = {{response.body.access_token}}提取,后续请求就能用Authorization: Bearer {{accessToken}}——注意这个语法只在.http文件内有效,跨文件不共享
响应 JSON 默认不格式化,点一下才好看
返回 200 OK 不代表调试完成。很多开发者看到乱成一行的 JSON 就以为“接口通了”,其实字段结构、嵌套层级、空值逻辑全被掩盖。
- 响应面板右上角有 Format Response 按钮({} 图标),点击即可美化当前响应;这不是设置项,每次都要手动点
- 不要依赖
rest-client.responsePreviewEnable这类设置,它控制的是是否弹窗预览,和格式化无关 - 如果响应体是二进制(如图片、PDF),
REST Client会显示 Base64 编码,此时点 Save Response 才能存为原始文件
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











