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

直接说结论：用 `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` 中显式绑定： ```json {"key": "ctrl+alt+r", "command": "rest-client.request"} ``` ### 请求写不对，`Send Request` 就不会出来 常见写法错误导致整个请求块被忽略： - 第一行不是大写方法 + 空格 + URL：比如写成 `get https://...`（小写）、`GEThttps://...`（缺空格）、`GET https://www.php.cn/link/5b5b52a6c9e01878c6c7bfe893ea244d`（# 后内容会被截断） - 请求头冒号后没空格：`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` 或其他），放在项目根目录 - 结构必须是对象套对象： ```json {"dev": {"baseUrl": "https://www.php.cn/link/c1d18eefb1bd1698c74653c0980f950d"},"prod": {"baseUrl": "https://www.php.cn/link/766f5dee4fe81aba12de2750d0c30ac1"}} ``` - 使用时写 `GET {{baseUrl}}/users`，右下角状态栏点击环境名即可切换 - 注意：变量只在当前工作区生效，跨文件夹打开项目时，VSCode 可能读不到根目录的 `rest-client.environment.json`，建议用「File → Open Folder」方式打开完整项目 响应 JSON 默认不格式化，点右上角 `Format Response`（{} 图标）最直接；想默认开启？关掉 `rest-client.previewResponseInUntitledDocument` 设置（设为 `false`），同时确保 `rest-client.responsePreviewEnable` 是 `true`。但多数人其实只需要临时点一下——毕竟不是每个响应都值得长期保留格式化视图。