必须安装作者Huachao Mao、ID为humao.rest-client的正版插件;文件须保存为.http/.rest后缀;首行必须是完整请求行(如GET https://);变量定义置顶;请求头与体间有且仅一个空行。

装 REST Client 插件必须认准作者和 ID
VSCode 扩展市场搜 “REST Client” 会出来一堆同名插件,但只有 humao.rest-client 这个 ID、作者是 Huachao Mao 的才是官方维护版。装错容易遇到发请求卡在 loading、快捷键不响应、或者新版 VSCode 下直接报错。安装前务必点进详情页确认:安装量超 700 万、最后更新时间在近三个月内、没有“Deprecated”或“Unmaintained”提示。
.http 文件后缀和保存状态缺一不可
文件名必须以 .http(或 .rest)结尾,test.txt、api.js、甚至没后缀的临时文件,VSCode 都不会启用 REST Client 功能。常见现象是按 Ctrl+Alt+R(Windows/Linux)或 Cmd+Alt+R(macOS)完全没反应——先检查右下角状态栏有没有出现 HTTP 图标,再确认文件是否已保存(未保存的文件不触发语言模式)。
请求格式对空行和缩进极其敏感
REST Client 按 RFC 2616 解析文本,不是“看着像就行”。一个多余空格、少一个空行、多一个缩进,都可能导致静默失败或 400 错误:
-
GET和 URL 必须在同一行,中间不能有空格:GET https://httpbin.org/get✅,GET "https://..."❌ - 请求头必须顶格写,冒号后至少一个空格:
Content-Type: application/json✅,Content-Type:application/json❌ - Header 和 Body 之间必须且仅有一个空行;Body 必须顶格,不能缩进
- URL 中含空格或特殊字符,用
%20编码,别用+ - Windows 用户建议用 LF 换行(Unix 风格),CRLF 可能触发
Invalid request line
二进制响应默认不显示,不是请求失败
请求返回 PDF、PNG、ZIP 等二进制内容时,响应窗口默认以 UTF-8 解析,结果是乱码或空白。这不是接口问题,而是展示方式不匹配。正确做法是:
- 点击响应头里
Content-Type后面的View as Binary链接,直接查看原始字节流 - 右键响应区域 →
Save Response As...保存到本地再打开 - 别盯着空白响应页反复重发——状态码 200 和响应头正常就说明请求成功了
最常被忽略的是变量定义和空行逻辑:写 {{host}} 不等于自动有值,它只是占位符;而看似无关紧要的一个空行,可能让整个 body 被当成 header 解析掉。


















