必须装对作者为Huachao Mao、ID为humao.rest-client的插件,保存为.http/.rest文件,首行写合法请求,三者缺一不可;否则Ctrl+Alt+R等快捷键不触发发送。

装对插件、保存为 .http 文件、首行写合法请求——三者缺一不可,否则 Ctrl+Alt+R(Windows/Linux)或 Cmd+Alt+R(macOS)根本不会触发发送。
怎么确认 REST Client 插件装对了
VS Code 扩展市场搜 “REST Client”,会出现多个同名插件。必须认准作者是 Huachao Mao、ID 为 humao.rest-client 的那个。安装量超 700 万、更新日志活跃到 2026 年 4 月的是正主;点进详情页看 “Publisher” 字段,不是 humao 的都别装。
装完必须重载窗口:按 Ctrl+Shift+P(macOS 是 Cmd+Shift+P),输入 Developer: Reload Window 并执行。不 reload,右下角不会出现 HTTP 图标,.http 文件也不会有语法高亮和 Send Request 命令。
如果重载后仍无反应:
- 打开命令面板搜
REST Client: Switch Environment,能调出来就说明插件已加载 - 在 Extensions 页面搜索
rest-client,确认状态是 “Enabled”,不是 “Disabled by another extension” - 别手动下载
.vsix安装——VS Code 1.80+ 对未签名插件限制变严,容易卡在 “Installing…” 或报签名校验失败
为什么 .http 文件里点 Send Request 没反应
90% 是文件没被识别为 HTTP 类型。REST Client 只响应后缀为 .http 或 .rest 的已保存文件。临时文件、.txt、.md、甚至无后缀的文件,快捷键和右键菜单都不会出现。
即使后缀对了,第一行也必须是合法请求行:
- 顶格写、无注释、无空格缩进
- 协议完整(
https://不能少),不能加引号 - 中文参数必须 URL 编码,比如
name=%E5%BC%A0%E4%B8%89,别用+ - Windows 用户注意换行符:必须是 LF(Unix 风格),不是 CRLF;否则可能报
Invalid request line - 光标必须停在请求块内——不能在空行、注释行、或
###分隔符上 - 用了
{{var}}却没定义变量?它不会报错,而是静默失败,请求发不出
怎么写一个带 JSON body 和 Authorization 的 POST 请求
结构必须严格遵循 “请求行 → 请求头 → 空行 → 请求体” 顺序,中间不能漏空行,也不能多空行:
POST https://api.example.com/login HTTP/1.1
Content-Type: application/json
Authorization: Bearer {{token}}
{
"username": "admin",
"password": "123456"
}
常见踩坑点:
-
Content-Type必须显式声明为application/json,否则后端可能解析失败 - 认证头类型要匹配服务端要求:
Bearer、Basic、Digest或AWS4-HMAC-SHA256等,拼写和大小写都不能错 - JSON body 必须是合法 JSON 格式(双引号、无尾逗号、字符串转义正确),否则请求会 400
- 如果用变量如
{{token}},需提前在@headers或环境配置中定义,否则发出去的是字面量{{token}}
最易被忽略的是换行符和空行:LF 和 CRLF 混用、请求头与 body 之间少一个空行、body 开头多一个空格——这些都会让 REST Client 拒绝解析,但又不报明确错误,只默默不响应。


















