thunder client装完需重载窗口并手动打开界面;发请求须补全协议、确保服务运行;post传json要选raw+json模式;环境变量需正确创建、切换并验证替换。

Thunder Client 装完打不开请求界面?先检查是否启用并重载窗口
插件安装后不会自动弹出界面,必须手动触发。按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)打开命令面板,输入 Thunder Client: Open Request 并回车;或者点击左侧活动栏的闪电图标(若未显示,右键活动栏 → “显示” → 勾选 Thunder Client)。常见错误是装完就关掉 VSCode,没重载窗口——插件需重启窗口或重载窗口(Developer: Reload Window)才能完全激活。
发 GET 请求 404 或连接拒绝?确认 URL 格式与服务状态
Thunder Client 默认不补全协议和端口,localhost:3000/api/users 会被当成本地文件路径处理,必须写成 http://localhost:3000/api/users 或 https://api.example.com/v1/data。另外,它不启动服务,只发请求——如果后端没跑起来,会报 connect ECONNREFUSED 127.0.0.1:3000。验证方式:用浏览器或 curl http://localhost:3000/health 先确认服务可达。
POST 请求传 JSON 却被当成表单?切换 Body 类型再设 Content-Type
默认 Body 类型是 form-data,直接粘贴 JSON 会失败。必须点 Body 区域右上角下拉菜单,选 raw → 再选右侧 JSON(此时自动加 Content-Type: application/json)。如果手动改了 Content-Type 但没切对 raw 模式,服务器仍可能解析为空体。另外,JSON 中字段名必须用双引号,{user: "alice"} 是非法 JSON,会返回 400 Bad Request。
环境变量怎么复用?别硬编码,用 Environment + Variables 面板
在 Thunder Client 左侧边栏点 Environments → + New Environment,建一个 dev 环境,填入:
{
"host": "http://localhost:3000",
"api_key": "sk-test-xxx"
}然后在请求 URL 里写 {{host}}/api/items,Header 里写 Authorization: Bearer {{api_key}}。注意变量名不能含短横线(base-url ❌),只能用字母、数字、下划线;且环境切换按钮在请求编辑区右上角,不点就不会生效。
环境变量看着省事,但容易漏切环境或拼错 key 名——建议第一次配完立刻发个请求,看左下角状态栏是否显示“Environment: dev”,再检查请求预览里的 URL 是否已替换成功。











