必须安装作者为Huachao Mao、ID为humao.rest-client的正版REST Client插件，文件保存为.http/.rest后缀，首行写完整请求行（如GET https://...），变量定义需置于文件顶部且命名合法，请求头与体间须有且仅有一个空行。
装对插件、保存为 .http 后缀、第一行写完整请求行，这三步没做对，后面全白搭。
怎么确认装的是正版 REST Client 插件
VSCode 扩展市场搜 “REST Client”，排第一的未必是你想要的那个——必须点进去看作者和 ID。正确版本作者是 Huachao Mao（也写作 Humao），ID 是 humao.rest-client，安装量超 700 万。装错常见后果：按 Ctrl+Alt+R 没反应、发请求卡在 loading、不支持 {{var}} 变量语法。
- 别信“REST Client for VS Code”“HTTP Client”这类名字近似的插件，它们不是同一个东西
- 装完建议重载窗口：
Ctrl+Shift+P→ 输入Developer: Reload Window→ 回车 - 装对后，打开任意
.http文件，状态栏右下角应出现 HTTP 图标，且右键菜单里有Send Request
为什么写了 GET https://xxx 却按不动 Send Request
最常见原因是文件没保存或后缀不对。REST Client 只识别 .http 或 .rest 后缀的文件，.txt、.md、无后缀都不行；而且必须已保存（未保存的临时文件不触发语言模式）。
- 新建文件后立刻重命名为
api.test.http，再写内容 - 第一行必须是完整请求行，例如
GET https://httpbin.org/get，不能漏协议（https://），不能写成get（大小写敏感） - 如果光标不在请求行上，
Ctrl+Alt+R会失效；必须把光标放在 URL 行任意位置再按
带 Token 的 POST 请求老是 401，头和体怎么写才对
Bearer Token 必须严格写成 Authorization: Bearer {{token}}，中间一个空格不能少，冒号后一个空格也不能少；请求头和请求体之间必须且仅有一个空行。
- 变量定义要放在文件顶部，用
@token = eyJhbG...这种格式，不能写成token=...或含短横线（如@api-token） - Body 是 JSON 时，
Content-Type: application/json必须显式写出，否则默认当 text/plain 处理 - 响应是 PDF/PNG 等二进制时，编辑器默认显示乱码——这不是失败，右键响应区选
Save Response As或点View as Binary就能确认内容正常
多环境切换和变量复用容易踩哪些坑
变量只在当前 .http 文件生效，跨文件不共享；环境变量配置路径和优先级容易搞混，.rest-client 文件（点开头）只在项目根目录下有效，.vscode/settings.json 里的 rest-client.environmentVariables 才是工作区级配置。
- 别把
@env = dev写在请求块中间，它必须出现在文件最上方，且前面不能有空行 -
rest-client.environmentVariables的值是对象，key 是环境名（如dev），value 是变量映射，不是扁平键值对 - 中文、空格、短横线出现在变量名里会直接导致解析失败，报
Invalid request但不提示具体哪一行
真正卡住人的从来不是语法有多难，而是空行位置、变量命名规则、文件后缀、插件作者这几个点没对齐——每个都看似小细节，合起来就是发不出请求。
