rest client 插件需以 .http 或 .rest 为后缀的文件才能启用,请求块须以大写 method+空格+url 开头,用空行分隔,header 冒号后需空格,json 请求体紧随空行且不缩进,响应 json 需手动点 format response 美化。

Rest Client 插件能直接在 VSCode 里发 HTTP 请求,不用切到 Postman 或 curl,但必须按它认的语法写请求,否则连发送按钮都不会出现。
请求文件必须以 .http 或 .rest 为后缀
VSCode 不会识别 api-test.txt 或没后缀的文件。新建文件时手动输入 test.http,保存后才能触发 Rest Client 的语法高亮和发送功能。如果已写好内容但没后缀,直接重命名即可——插件不会丢失已有请求块。
每个请求块之间用空行分隔,且必须以 METHOD + URL 开头
常见错误是漏掉空行、写成 GEThttps://api.example.com(缺空格)、或把注释放在第一行导致解析失败。正确格式如下:
GET https://jsonplaceholder.typicode.com/posts/1
Accept: application/json
POST https://jsonplaceholder.typicode.com/posts
Content-Type: application/json
{
"title": "foo",
"body": "bar",
"userId": 1
}
- 方法名(
GET、POST等)必须大写,后跟一个空格,再跟 URL - 请求头每行一条,
Key: Value格式,冒号后需有空格 - 请求体(如 JSON)必须紧跟空行之后,不能缩进也不能加额外空行
- 支持环境变量,比如
{{baseUrl}}/posts,但需先在rest-client.environmentVariables配置中定义
响应体默认不自动格式化 JSON,需手动启用
即使返回的是标准 JSON,Rest Client 默认以纯文本显示。要开启美化,需在 VSCode 设置中搜索 rest-client.previewResponseInUntitledDocument 并关闭它(设为 false),同时确保 rest-client.responsePreviewEnable 为 true。更简单的方式是:响应窗口右上角点击 Format Response 按钮(图标为 {}),它只对当前响应生效,不依赖设置。
带认证或复杂 Header 时,容易忽略换行和编码问题
例如 Bearer Token 写成:Authorization: Bearer eyJhbG... (末尾多了一个空格)会导致 401;又或者中文参数没做 URL 编码,直接写 q=上海 会报 400。实际建议:
- Token 类值复制后检查首尾空白,粘贴到
Authorization后不要回车换行 - URL 中含中文或特殊字符时,用
encodeURIComponent()处理,或改用变量:@q = encodeURIComponent("上海"),然后在 URL 中写?q={{q}} - Cookie 头不支持自动管理,需手动拼接
Cookie: a=1; b=2,不能分行写
最常被忽略的是:请求块之间空行必须是“真正的空行”(不含空格或制表符),编辑器显示的空白字符容易骗人——打开 VSCode 的“显示不可见字符”(Ctrl+Shift+P → Toggle Render Whitespace)能立刻暴露问题。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











