必须安装作者huachao mao的rest client扩展并重启vscode,新建test.http文件,首行写get https://httpbin.org/get,按ctrl+alt+r发送;语法须严格:方法与url同行、头冒号后一空格、头与体间空一行、变量用{{var}}且定义在.rest-client或文件顶部。

VSCode本身不带API测试能力,必须装扩展才能发请求;REST Client是目前最轻量、语法最贴近HTTP协议的选择,但配置错一个字符就会发送失败。
安装REST Client扩展并确认生效
装完不重启,90%的“点不动”问题就出在这儿。官方扩展作者是Huachao Mao,别选错名字相似的替代品。
- 打开VS Code扩展面板(Ctrl+Shift+X),搜
REST Client,点安装 - 安装后必须重启VS Code——部分版本不重启不会加载语法高亮和快捷键
- 新建文件,保存为
test.http(不是test.txt,也不是没后缀),输入GET https://httpbin.org/get,看右下角语言模式是否自动变成HTTP;如果不是,手动点击右下角→Configure File Association for '.http'→选HTTP - 光标停在
GET行,按Ctrl+Alt+R(Windows/Linux)或Cmd+Alt+R(Mac),弹出“Sending request…”即成功
.http文件语法必须严格对齐
它不解析curl命令,也不认JS注释,空格、换行、冒号后多一个空格都会导致Invalid request method或400错误。
- 第一行必须是
方法 URL,例如POST https://api.example.com/login,不能写成curl -X POST - Header每行一个,格式为
Key: Value,冒号后**必须有且仅有一个空格**,Content-Type: application/json✅,Content-Type:application/json❌ - Header与Body之间**必须空一行**,Body开头不能有空行,否则整段被当注释忽略
- JSON Body可换行缩进,但首字符必须顶格,
{ "name": "Alice" }✅,{ "name": "Alice" }❌ - 中文、空格、
&等直接写,GET https://api.com?q=你好&sort=desc会被自动URI编码,不用手写%E4%BD%A0
环境变量配置:三种方式优先级不同
变量不是随便定义就能用,作用域和加载顺序决定哪个值最终生效,硬编码{{token}}却始终为空,大概率是定义位置错了。
- 文件内定义(最高优先级):
@host = https://dev.api.com写在.http文件顶部,只对当前文件生效 - 工作区级配置(推荐):在项目根目录建
.rest-client(无后缀),内容为@token = abc123,所有.http文件都可读取,且可加到.gitignore保护敏感信息 - 全局环境配置(最低优先级):VS Code设置里搜
REST Client: Environment Variables,填JSON格式,如{"dev": {"host": "https://dev.api.com"}},再用Ctrl+Alt+E切换环境 - 引用时统一用
{{host}},但注意:.rest-client里的变量不支持嵌套引用,@baseUrl = https://{{host}}/v1会报错
HTTPS证书失败、超时、响应卡死怎么调
这些不是功能缺陷,而是默认策略——开发时关SSL验证、调大超时、跳过渲染大响应体,三步就能解决95%的“发不出去”或“卡住”问题。
- 内网自签证书报
SSL certificate problem:在请求前加注释# @no-ssl-verification(仅限开发环境) - 请求等十几秒才返回或超时:在请求前加
# @timeout = 30000(单位毫秒),支持每个请求单独设 - 响应体几MB,VS Code界面卡死:别强撑着看渲染结果,右键响应窗口→
Copy Response Body,粘贴到外部编辑器查 - 需要保持登录态?REST Client默认无Cookie管理,
Set-Cookie不会自动带入下个请求,得手动提取再写Cookie: xxx
最容易被忽略的是变量作用域和文件关联——.rest-client文件名不能带.json后缀,.http文件右下角语言模式必须是HTTP,这两个点一错,所有变量和语法高亮都失效,但错误提示几乎为零。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











