如何在VSCode里运行并测试API接口 - 插件推荐

用 REST Client 插件就够了，轻量稳定、语法直白，90% 日常调试无需切换窗口或管理会话；需环境切换、自动鉴权或保存请求集合时再选 Thunder Client。

直接说结论：用 REST Client（作者 Huachao Mao）就够了，轻量、稳定、语法直白，90% 的日常调试不需要切换窗口或管理会话状态。如果需要环境切换、自动鉴权或保存请求集合，再考虑 Thunder Client；别一上来就装一堆插件。

---

REST Client 插件怎么装才真正生效

• 安装后必须重启 VSCode（尤其 Windows/Linux 用户），否则语法高亮和 Send Request 链接可能不出现
• 新建文件时不能只写内容再改后缀：先手动输入 test.http 或 api.rest 作为文件名，保存后插件才开始监听
• 如果右下角语言模式显示的是「Plain Text」而不是「HTTP」，点它 → 选「Configure File Association for '.http'」→ 设为 HTTP
• 快捷键 Ctrl+Alt+R（Win/Linux）或 Cmd+Alt+R（macOS）失效？检查是否被 Vim/Emacs 插件劫持，可在 keybindings.json 中显式绑定：

  {"key": "ctrl+alt+r", "command": "rest-client.request"}

---

请求写不对，Send Request 就不会出来

常见写法错误导致整个请求块被忽略：

• 第一行不是大写方法 + 空格 + URL：比如写成 get https://...（小写）、GEThttps://...（缺空格）、GET <a href="https://www.php.cn/link/5b5b52a6c9e01878c6c7bfe893ea244d">https://www.php.cn/link/5b5b52a6c9e01878c6c7bfe893ea244d</a>（# 后内容会被截断）
• 请求头冒号后没空格：Content-Type:application/json ❌ → 必须是 Content-Type: application/json ✅
• Body 前少一个空行：Header 和 JSON 之间必须严格空一行，多一行或没空行都会让 Body 被当成 Header 解析，返回 400
• JSON Body 缩进了：{ "id": 1 } ✅，但 { "id": 1 } ❌（开头有空格）会导致解析失败
• 文件里第一行写了注释（如 # GET /users）：注释必须放在请求块内部，不能占首行，否则插件直接跳过该块

---

多环境变量怎么设才不踩坑

• 变量定义文件名必须是 rest-client.environment.json（不是 .env 或其他），放在项目根目录
• 结构必须是对象套对象：

  {"dev": {"baseUrl": "<a href="https://www.php.cn/link/c1d18eefb1bd1698c74653c0980f950d">https://www.php.cn/link/c1d18eefb1bd1698c74653c0980f950d</a>"},"prod": {"baseUrl": "<a href="https://www.php.cn/link/766f5dee4fe81aba12de2750d0c30ac1">https://www.php.cn/link/766f5dee4fe81aba12de2750d0c30ac1</a>"}}

• 使用时写 GET {{baseUrl}}/users，右下角状态栏点击环境名即可切换
• 注意：变量只在当前工作区生效，跨文件夹打开项目时，VSCode 可能读不到根目录的 rest-client.environment.json，建议用「File → Open Folder」方式打开完整项目

---

响应 JSON 默认不格式化，点右上角 Format Response（{} 图标）最直接；想默认开启？关掉 rest-client.previewResponseInUntitledDocument 设置（设为 false），同时确保 rest-client.responsePreviewEnable 是 true。但多数人其实只需要临时点一下——毕竟不是每个响应都值得长期保留格式化视图。