必须安装作者Humao、ID为humao.rest-client的REST Client插件,文件需保存为.xxx.http后缀才能启用语法高亮和Send Request功能,GET请求须与URL同行且无多余空格,请求头与URL间不可有空行但请求体前必须空一行,变量引用需配合rest-client.environment.json文件,二进制响应需手动切换View as Binary或另存查看。

VSCode里装REST Client插件要找对名字
搜“REST Client”时容易点错成其他同名但不维护的插件,必须认准作者是 Humao、ID 是 humao.rest-client 的那个。VSCode 扩展市场里搜出来的第一个通常就是,但建议点进去看作者和安装量(超 700 万),避免装到 fork 或仿版——那些可能不支持最新 VSCode 版本,或者发请求时卡在 loading 状态没报错也没响应。
写 .http 文件后缀才能触发语法高亮和发送功能
REST Client 不会自动识别 .txt 或无后缀文件里的 HTTP 请求。必须把测试文件保存为 xxx.http(比如 api-test.http),VSCode 才会加载对应语言模式,启用 Send Request 命令。右键菜单或快捷键 Ctrl+Alt+R(Windows/Linux)或 Cmd+Alt+R(macOS)才有效;如果文件是 .md 或 .js,快捷键根本不会出现。
常见错误现象:写完 GET https://httpbin.org/get 按快捷键没反应 → 先检查文件后缀是不是 .http。
基础请求写法和变量引用要注意格式细节
最简请求只要一行 URL 就能发,但加空行、空格、换行位置不对会导致解析失败:
-
GET和 URL 必须在同一行,中间不能有空格(GET https://...❌) - 请求头必须跟在 URL 下方,且与 URL 之间**不能有空行**;但请求体(如 JSON)前必须有**一个空行**
- 环境变量用
{{host}}写法,但得先在同目录下建rest-client.environment.json,否则会提示Cannot resolve variable 'host'
示例(合法):
GET https://httpbin.org/get
User-Agent: rest-client
{
"test": true
}
响应体默认不显示二进制内容,大文件或图片要手动切换
发请求拿到 PDF、PNG 或 ZIP 时,编辑器默认只显示乱码文本或直接空白——这不是失败,而是 REST Client 默认以 UTF-8 解析响应体。右键响应窗口,选 Save Response As... 保存到本地再打开;或者点击响应头里的 Content-Type 后面的 View as Binary 链接,就能看到原始字节流。
这个行为容易被当成“请求没成功”,其实状态码 200、响应头都正常,只是展示方式不匹配类型。


















