怎么在VSCode中使用REST Client_VSCode接口测试与HTTP请求发送插件-VSCode-PHP中文网

必须认准作者Huachao Mao、ID为humao.rest-client的插件，安装后重载窗口，文件保存为.http后缀且首行顶格写合法请求（如GET https://api.example.com/users），三者缺一不可，否则快捷键Ctrl+Alt+R/Cmd+Alt+R无效。

怎么在vscode中使用rest client_vscode接口测试与http请求发送插件

装对插件、保存为 .http 后缀、首行写对请求格式，三者缺一不可——否则 Ctrl+Alt+R（Windows/Linux）或 Cmd+Alt+R（macOS）根本不会触发发送。

怎么确认 REST Client 插件装对了

VSCode 扩展市场搜 “REST Client” 会出现多个同名插件，必须认准作者是 Huachao Mao、ID 是 humao.rest-client 的那个。安装量超 700 万、更新日志活跃到 2026 年 4 月的是正主；点进去看详情页的 “Publisher” 字段，不是 humao 的都别点安装。

装完必须重载窗口：按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Developer: Reload Window 并执行。不 reload，右下角不会出现 HTTP 图标，.http 文件也不会有语法高亮和 Send Request 命令。

如果重载后仍无反应，打开命令面板搜 REST Client: Switch Environment，能调出来就说明插件已加载
检查是否被其他插件禁用：在 Extensions 页面搜索 rest-client，确认状态是 “Enabled”，不是 “Disabled by another extension”
别手动下载 .vsix 安装——VSCode 1.80+ 对未签名插件限制变严，容易卡在 “Installing…” 或报签名校验失败

为什么 .http 文件里点 Send Request 没反应

90% 是文件没被识别为 HTTP 类型。REST Client 只响应后缀为 .http 或 .rest 的**已保存文件**。临时文件、.txt、.md、甚至无后缀的文件，快捷键和右键菜单都不会出现。

即使后缀对了，第一行也必须是合法请求行：顶格写、无注释、无空格缩进、协议完整（https:// 不能少）、不能加引号。下面这些全错：

GET "https://api.example.com/users"
  GET https://api.example.com/users
// GET https://api.example.com/users
GET https://api.example.com/users?name=张三

正确写法只有一种：GET https://api.example.com/users?name=%E5%BC%A0%E4%B8%89（中文要 URL 编码，别用 +）。

Windows 用户注意换行符：必须是 LF（Unix 风格），不是 CRLF；否则可能报 Invalid request line
光标必须停在请求块内——不能在空行、注释行、或 ### 分隔符上
用了 {{var}} 却没定义变量？它不会报错，而是静默失败，请求发不出

怎么写一个带 JSON body 和 Authorization 的 POST 请求

结构必须严格遵循 “请求行 → 请求头 → 空行 → body”，三者之间不能错位。多一个空行、少一个空行、header 冒号后没空格、body 缩进了，都会导致 body 被忽略或 header 解析失败。

常见错误：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

Content-Type:application/json（冒号后没空格）→ 失效
Authorization: Bearer{{token}}（Bearer 和 token 间没空格）→ 后端拒绝，返回 400 或 401
JSON body 顶格写但用了单引号：{'name': 'alice'} → 后端解析失败
复制 AI 生成的 JSON，里面混入了不可见的零宽字符或 smart quote → 发出去的 body 是乱的

正确示例：

POST https://api.example.com/v1/users
Content-Type: application/json
Authorization: Bearer {{token}}

{"name":"alice","email":"alice@example.com"}

注意：Authorization 头必须紧挨着请求行写，中间不能有空行；body 前必须且仅有一个空行；JSON 必须用英文双引号，且不能缩进。

环境变量和变量作用域怎么不踩坑

变量不是写上 {{host}} 就自动有值。它分三种来源，优先级从高到低：文件内 @host = 定义 > 工作区 rest-client.environmentVariables 配置 > 全局 .rest-client 文件。跨文件不共享，@ 定义只对当前请求块生效。

工作区配置写在 .vscode/settings.json 里，格式必须严格：

{
  "rest-client.environmentVariables": {
    "dev": {
      "host": "https://api.dev.example.com",
      "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"
    }
  }
}

然后在 .http 文件顶部写：@env = dev 切换环境，再用 {{host}} 引用。