ctrl+alt+r没反应，须同时满足：安装启用humao.rest-client插件、文件已保存且后缀为.http或.rest、光标停在合法请求行（如get https://...）上。
Ctrl+Alt+R 按下没反应？先查这三件事
快捷键失效不是插件坏了，而是 VSCode 根本没把当前文件当 HTTP 请求处理。必须同时满足：humao.rest-client 插件已安装并启用、文件已保存且后缀为 .http 或 .rest、光标正停在合法请求行上（比如 GET https://api.example.com 这一行）。
常见卡点：
- 文件是
test.txt或未保存的 Untitled-1 —— VSCode 不识别，快捷键根本不会注册 - 插件装错：搜 “REST Client” 出来好几个，只认作者
Huachao Mao、IDhumao.rest-client的那个（安装量超 700 万，最近更新在 2026 年 4 月） - 装完没重载窗口：按
Ctrl+Shift+P输入Developer: Reload Window执行，否则右下角看不到 HTTP 图标，Send Request命令也不出现
为什么光标停在 POST 请求里却发不出？空行和缩进是硬伤
REST Client 对格式零容忍。它不是靠“看起来像”来解析，而是严格按 RFC 规则切分请求头与 body。一个空行错位，整个请求就废了。
关键规则：
-
Content-Type: application/json必须显式写出；缺省是text/plain，很多后端直接返回 400 - 请求头和 JSON body 之间**必须且仅有一个空行**：多一个，body 被当成 header；少一个，body 被吞掉
- JSON body 必须顶格写，不能缩进；字符串用英文双引号，不能有
//注释或不可见字符（AI 生成内容常带隐藏换行符） - 示例合法写法：
POST https://httpbin.org/post<br>Content-Type: application/json<br><br>{"name":"alice","age":30}
快捷键被 Vim 或其他插件劫持怎么办？
Ctrl+Alt+R（Windows/Linux）或 Cmd+Alt+R（macOS）默认绑定到 rest-client.request 命令，但 Vim 插件等会覆盖该组合键。
解决方法：
- 打开键盘快捷键设置（
Ctrl+K Ctrl+S），搜索rest-client.request - 点击右侧铅笔图标，重新绑定为不冲突的组合，比如
Ctrl+Alt+H - 或者禁用 Vim 插件的
Ctrl+Alt+R映射（在 Vim 设置里找vim.useCtrlKeys或自定义 keybindings）
响应里中文乱码或 PDF 空白？不是请求失败，是展示方式错了
状态码 200、响应头正常，但右边面板显示乱码或一片空白——大概率是二进制响应（PDF、PNG、ZIP）被强行按 UTF-8 解析了。
正确操作：
- 右键响应区域 →
Save Response As保存到本地再打开 - 或点击响应头中
Content-Type后面的View as Binary链接，切换成原始字节流视图 - 别指望自动解码：REST Client 不做 MIME 类型智能推断，
text/html和application/pdf都按文本渲染，除非你手动切模式
变量引用、环境切换、大响应体卡顿这些事，都建立在请求能发出去的基础上——而发出去的前提，就是那三行：装对插件、存成 .http、首行顶格写对请求。其余都是锦上添花，不是雪中送炭。
