vscode装rest client插件后需重启窗口才生效,编写 .http 文件时首行须为完整请求行,请求头与body间有且仅一个空行,变量用 {{var}} 且定义在文件顶部。

VSCode里装REST Client插件就能发HTTP请求
不用额外开Postman,REST Client 是 VSCode 官方市场里最成熟、零配置即用的 HTTP 请求工具。它不依赖外部服务,所有请求写在 .http 或 .rest 文件里,编辑、发送、看响应一气呵成。
安装后必须重启VSCode或重载窗口才生效
装完插件不重启,Send Request 命令根本不会出现在右键菜单或命令面板里——这是新手踩得最多的一坑。VSCode 插件机制对语言服务器类扩展(比如 REST Client)要求严格,热重载不一定触发初始化。
- 装完点右上角「齿轮」→「Reload Window」,或者按
Ctrl+Shift+P(macOS 是Cmd+Shift+P),输入Developer: Reload Window执行 - 确认状态栏右下角出现
HTTP图标,且打开任意.http文件后有语法高亮 - 如果仍没反应,检查是否被其他插件禁用,或在
Extensions页面手动启用REST Client
写一个能跑通的 .http 文件要注意三件事
REST Client 对空行、空格、协议头格式敏感,错一处就报 Invalid request 或直接静默失败,不是所有错误都会弹红框。
- 第一行必须是完整请求行,比如
GET https://httpbin.org/get,不能漏https://,也不能写成get(大小写敏感) - 请求头和 body 之间必须有且仅有一个空行;多个请求之间也必须用至少一个空行隔开
- 变量要用
{{var}},定义必须放在文件顶部,用@host = https://httpbin.org这种格式,不能写成host=https://...
示例:
GET {{host}}/get
Content-Type: application/json
{
"test": true
}
带认证、环境变量、多环境切换怎么写
实际项目里不可能硬编码 URL 和 token。REST Client 支持全局变量 + 工作区级 rest-client.environmentVariables 配置,但路径和优先级容易搞混。
- 工作区配置写在
.vscode/settings.json里,键名是rest-client.environmentVariables,值是一个对象,key 是环境名(如dev),value 是变量映射 - 在
.http文件里用@env = dev切换环境,再用{{host}}引用对应变量 - Bearer Token 推荐用
Authorization: Bearer {{token}},token 值从环境变量来,别手写进文件里 - 注意:变量名不能含短横线(
-),否则解析失败;中文或空格会直接报错
复杂点在于环境变量只在当前工作区生效,跨文件夹要复制配置;另外 token 过期后得手动更新,它不自动刷新。真要模拟 Postman 的 Collection Runner 或自动鉴权,就得另配脚本或换工具了。











