必须安装作者Huachao Mao、ID为humao.rest-client的正版插件,文件保存为.http/.rest后缀且首行为顶格合法请求(如GET https://),三者缺一不可;装后需重载窗口,否则Ctrl+Alt+R无效、无HTTP图标及语法高亮。

VSCode 里直接发 HTTP 请求不是靠内置功能,而是必须装对插件、写对格式、用对后缀——三者缺一不可,否则 Ctrl+Alt+R 按了也没反应,右键菜单里根本找不到 Send Request。
怎么确认 REST Client 插件装对了
VSCode 扩展市场搜 “REST Client” 会出来一堆同名插件,真正能用的是作者 Huachao Mao、ID 为 humao.rest-client 的那个。安装量超 700 万、最近更新在 2026 年 4 月之后的才是正主。点进详情页看 Publisher 字段,不是 humao 的都别装。
装完必须执行 Developer: Reload Window(快捷键 Ctrl+Shift+P 输入后回车),不重载,HTTP 图标不会出现在右下角,.http 文件也不会有语法高亮和命令支持。
如果重载后还是没反应,打开命令面板搜 REST Client: Switch Environment,能调出来就说明插件已加载;再检查 Extensions 页面里 humao.rest-client 状态是不是 Enabled,别被其他插件静默禁用。
为什么 .http 文件里点 Send Request 没反应
90% 是文件没被识别为 HTTP 类型。REST Client 只响应后缀为 .http 或 .rest 的**已保存文件**。临时文件、.txt、.md、甚至无后缀的文件,快捷键和右键菜单都不会出现。
- 第一行必须是合法请求行:顶格写、无空格缩进、协议完整(
https://不能少)、不能加引号或注释 -
GET https://api.example.com/users?name=张三是错的,中文必须 URL 编码:GET https://api.example.com/users?name=%E5%BC%A0%E4%B8%89 - Windows 用户注意换行符:必须是 LF(Unix 风格),不是 CRLF,否则可能报
Invalid request line - 光标必须停在请求块内——不能在空行、注释行、或
###分隔符上
POST 带 JSON body 和 Authorization 怎么写才不失败
结构必须严格遵循 “请求行 → 请求头 → 空行 → 请求体”,中间任何位置多一个空行、少一个空行都会解析失败。
常见错误现象:发出去状态码是 401 或 400,但请求头明明写了 Authorization —— 很可能是 Content-Type 没设对,或者 JSON body 缺少末尾换行,导致服务端收不到完整 body。
正确示例:
POST https://api.example.com/login
Content-Type: application/json
Authorization: Bearer {{token}}
{
"username": "admin",
"password": "123"
}
注意:{{token}} 要提前在 rest-client.environment.json 里定义,否则变量引用静默失效,请求照样发出去但带的是字面量 {{token}}。
响应是 PDF/PNG/ZIP 时为啥显示乱码或空白
这不是请求失败,是 REST Client 默认用 UTF-8 解析响应体,而二进制内容没法按文本渲染。状态码 200、响应头都正常,只是展示方式错了。
两种解决方式:
- 右键响应窗口 →
Save Response As保存到本地再打开 - 点击响应头里
Content-Type后面的View as Binary链接,就能看到原始字节流
这个细节最容易被当成“接口挂了”,其实只是编辑器默认行为不匹配响应类型。如果你常测文件上传/下载接口,记得每次先看 Content-Type 再决定怎么查看响应。


















