VSCode使用RESTClient：在.http文件中直接发送网络请求

VSCode REST Client插件仅识别 .http 或 .rest 后缀文件，需保存后生效

想在VSCode里直接发送网络请求？REST Client插件是个绝佳选择。但别急着敲代码，第一步就藏着关键细节：文件后缀名。插件只认.http或.rest这两种格式，其他像test.txt、api.js甚至无后缀的临时文件，统统不会被识别为HTTP请求的载体。

只有保存为正确的后缀，插件才会加载对应的语言模式，你才能看到语法高亮、Send Request按钮以及相关的快捷键。

文件后缀必须是 .http 或 .rest 才能触发功能

如果你遇到了Ctrl+Alt+R（Windows/Linux）或Cmd+Alt+R（macOS）按下没反应，或者右键菜单里压根找不到Send Request选项，别慌，先检查两个地方：

第一，文件名后缀对不对？第二，文件是否已经保存？未保存的临时文件，插件功能是不会生效的。

• 记住，快捷键是Ctrl+Alt+R（Windows/Linux）或Cmd+Alt+R（macOS）。
• 光标需要停在一个合法的请求块内，放在注释行或者空行上是没用的。
• 如果确认后缀和保存状态都没问题，插件还是不工作，不妨试试重启VSCode窗口（执行Developer: Reload Window命令）。

请求格式对换行和空行极其敏感

接下来是书写请求的环节。这里有个核心原则：REST Client严格按照RFC 2616标准来解析文本，这意味着它对格式的要求近乎“苛刻”，绝不是“差不多就行”。一个多余的空格、少一个必要的空行，甚至多了一个缩进，都可能导致请求发不出去、返回400错误，或者更糟——静默失败。

一个标准的请求结构是这样的：方法 URL → 空行（可选请求头）→ 空行 → （可选请求体）。这三部分之间的顺序和间隔，一点都不能错。

• 第一行必须是完整的请求行，比如GET https://httpbin.org/get。不能加引号，不能缩进，更不能写成注释形式如// GET ...。
• 请求头每行的格式是Key: Value，末尾不能有多余空格。多个请求头之间，也不能插入空行。
• Header和Body之间必须且仅有一个空行。请求体（比如JSON）必须顶格写，不要进行缩进。
• 当URL中包含空格或特殊字符时，记得使用%20进行编码，不要用+号代替。

变量引用必须配合定义，否则 {{var}} 就是字面量

为了提高效率，使用变量是个好习惯。但请注意，写下{{host}}并不代表它自动就有了值——它仅仅是一个占位符。你必须明确定义变量的来源。

变量主要分三种：文件内定义的@host = ...、环境变量（通过.rest-client配置文件或rest-client.environmentVariables设置）、以及系统预定义变量（如{{$datetime iso8601}}）。

这里最容易踩坑的是变量的作用域和优先级：文件内用@定义的变量，只在当前###分隔的请求块内生效；而通过工作区配置的环境变量，需要你手动通过命令面板（REST Client: Switch Environment）切换环境才会加载，不会自动读取。

• 避免在@变量定义里嵌套引用，例如@base = https://{{env}}.example.com这种写法是无效的。
• 变量命名建议使用小写字母加下划线的组合，尽量避免全大写，因为某些系统可能会强制转换为小写，导致变量名匹配失败。
• 使用###来分隔多个请求块，而不是---或***。

二进制响应默认不渲染，别误判为请求失败

最后，来看一个常见的“乌龙”场景：请求状态码显示200，响应头也一切正常，但右边的响应窗口却一片空白，或者全是乱码。怎么回事？

大概率是接口返回了PDF、PNG、ZIP这类二进制内容，或者非UTF-8编码的文本。REST Client默认以文本方式尝试解析响应体，一旦遇到无法解码的字节流，就会显示为空或乱码。

这并非bug，而是插件的设计如此。你需要主动切换查看方式：

• 在响应区域右键，选择Sa ve Response As...，将内容保存到本地后再打开查看。
• 或者，直接点击响应头中Content-Type字段后面的View as Binary链接。
• 需要注意的是，View as Binary这个操作不是永久性的，每次发送新的请求后，如果需要查看二进制内容，都得重新点击。

这个细节常常被误认为是“接口没通”，其实请求早已成功，只是展示逻辑没有跟上实际的内容类型而已。