Sublime Text 本身不支持发 HTTP 请求,需安装 RESTClient 插件;安装后必须重启编辑器,使用 .http 文件按规则书写请求,注意 headers 格式、空行分隔 body、环境变量配置及编码设置。

Sublime Text 本身不支持发 HTTP 请求
别折腾内置功能了——Sublime Text 是个编辑器,不是调试工具。它没有原生的 curl、fetch 或 HTTP 客户端能力。所有“发送请求”的操作,都得靠插件补上这一环。
最常用、维护活跃、配置轻量的是 RESTClient 插件(注意不是 RestClient 或 HTTP Client)。它用纯文本写请求,语法接近 cURL,但更易读,也支持环境变量和简单模板。
安装 RESTClient 插件的三个关键动作
很多人卡在第一步:装完插件却没反应。问题往往出在安装路径或快捷键冲突上。
- 用
Package Control: Install Package命令搜RESTClient(大小写敏感,官方仓库里是全大写 R-E-S-T-C-l-i-e-n-t) - 装完后必须重启 Sublime Text —— 不是重载窗口,是彻底关掉再打开,否则
Ctrl+Alt+R(Windows/Linux)或Cmd+Alt+R(macOS)不会生效 - 确认插件启用:菜单栏
Tools → RESTClient应该可见;如果灰掉,说明插件没加载成功,大概率是 Python 环境或插件缓存异常,删掉Packages/RESTClient/文件夹再重装一次
写一个能跑通的 .http 文件要注意什么
RESTClient 的核心是识别 .http 后缀文件,并按行解析请求。格式看着随意,其实有硬性规则。
- 必须以请求方法开头,比如
GET、POST,后面紧跟空格和 URL(不能换行) - Header 行必须顶格写,
:后要有一个空格,例如Content-Type: application/json,少空格会报Invalid header format - Body 要跟在空行之后,JSON 写错引号或逗号,
RESTClient不会提示语法错误,而是直接返回400 Bad Request或空响应 - 环境变量用
{{host}}这种写法,但必须提前在同目录下建.rest-client.env文件定义,例如:{ "local": { "host": "http://localhost:3000" } },且文件名不能拼错、不能加扩展名
为什么响应卡住、超时或中文乱码
不是网络问题,大概率是插件默认行为或系统限制导致的。
- 默认超时是 30 秒,长请求容易被中断;改法:在
Preferences → Package Settings → RESTClient → Settings里加"timeout": 120 - 中文响应体显示为
\u4f60\u597d?那是 UTF-8 编码正常,但 Sublime 默认用 ASCII 解析;在响应窗口右下角点击编码名(如UTF-8),选Reopen with Encoding → UTF-8即可 - HTTPS 请求失败报
Certificate verify failed:说明插件用了系统 OpenSSL,而某些 macOS 或 Windows 自带证书链不全;临时解决是在设置里加"verify_ssl": false(仅开发环境),长期建议用certifi替换证书包,但这需要手动改插件源码,不推荐
真正麻烦的从来不是怎么发请求,而是怎么让请求里的变量、认证头、多环境切换保持稳定又不污染主文件。.env 文件路径、header 大小写、body 换行位置——这些地方错一点,就只能看响应状态码猜哪错了。

















