httpie

httpie — 一款让API调试像写诗一样舒服的命令行HTTP客户端

如果你还在用 curl 加一堆 -H、-d、-X 参数怼API，那你大概率已经受够了那种“眼睛看花、手打抽筋”的体验。今天我要安利的这个工具——httpie，就是来拯救你调试接口的日常的。它不是什么新东西，但绝对是被低估的效率神器。

这货到底是干嘛的？

简单说，httpie 是一个命令行下的HTTP客户端，对标 curl，但设计哲学完全不同。它解决的核心痛点是：让HTTP请求的构造和响应阅读变得直观、可读、省脑力。

举个例子，你平时用 curl 发一个 POST 请求：

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer token123" -d '{"name":"test","age":18}' https://api.example.com/users

用 httpie 怎么写？

http POST https://api.example.com/users name=test age:=18 Authorization:"Bearer token123"

看到区别了吗？少了 -X、-H、-d 这些噪音，语法接近自然语言。而且最关键的是——响应结果默认带语法高亮、自动格式化JSON、显示响应头，看一眼就懂。

下载方式

官方下载入口在这里：httpie 官网
如果你喜欢用包管理器，往下看安装方法。

安装方法

httpie 支持几乎所有主流平台，安装方式极其友好：

macOS（推荐）

brew install httpie

Linux（Ubuntu/Debian）

apt install httpie

或者用 pip 装最新版（推荐）：

pip install httpie

Windows

• 用 Chocolatey：choco install httpie
• 用 Scoop：scoop install httpie
• 或者直接下载 exe 安装包（官网有）

验证安装

http --version

看到版本号就稳了。

基础使用教程

1. 最简单的GET请求

http https://api.github.com/users/octocat

你会看到彩色输出，JSON被自动缩进，响应头（Status、Content-Type等）用不同颜色区分。对比一下 curl 的纯文本输出，高下立判。

2. 带参数的GET

http https://api.example.com/search q==httpie page==1

注意：== 表示URL查询参数，= 表示请求体参数（后面会讲）。

3. POST请求发JSON

http POST https://api.example.com/users name=John age:=30

这里 name=John 是字符串，age:=30 用了 := 表示原始JSON值（数字/布尔/对象）。httpie 会自动把参数拼成JSON请求体，并设置 Content-Type: application/json。

4. 发表单数据

http --form POST https://api.example.com/login username=admin password=123456

加 --form 参数，数据就变成 application/x-www-form-urlencoded 格式了。

5. 自定义请求头

http GET https://api.example.com/data Authorization:"Bearer token123" X-Custom-Header:value

注意：冒号后面直接跟值，不需要空格。

6. 查看详细请求/响应

http -v https://api.example.com

-v 会打印完整请求行、请求头、请求体，以及响应全部内容。调试时超有用。

7. 下载文件

http -d https://example.com/file.zip

-d 表示下载，会自动保存为原始文件名。

进阶技巧（这才是精华）

1. 使用会话（Session）保持登录状态

如果你要连续调多个需要登录的接口，不用每次带token：

# 先登录，保存会话
http --session=mysession POST https://api.example.com/login username=admin password=123456

# 后续请求自动带上cookie/token
http --session=mysession GET https://api.example.com/profile

会话文件默认存在 ~/.httpie/sessions/ 下，可以随时查看或删除。

2. 从文件读取请求体

有时候请求体很长，写在一行里很痛苦：

http POST https://api.example.com/data < request.json

或者用管道：

cat request.json | http POST https://api.example.com/data

3. 使用环境变量隐藏敏感信息

写脚本时不想硬编码 token？用环境变量：

export API_TOKEN="your-secret-token"
http GET https://api.example.com/data Authorization:"Bearer $API_TOKEN"

httpie 也支持 .env 文件，配合 dotenv 工具更香。

4. 输出格式化控制

• --pretty=all（默认）：彩色+缩进
• --pretty=none：纯文本，适合重定向到文件
• --pretty=colors：只保留颜色，不缩进
• --print=H：只打印响应头
• --print=B：只打印响应体
• --headers：简写，等价于 --print=H

5. 模拟浏览器行为

有些API会检查 User-Agent，可以用：

http GET https://api.example.com User-Agent:"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"

6. 使用离线文档（OpenAPI/Swagger）

httpie 有一个实验性功能：如果你有 OpenAPI 规范文件，可以直接生成请求示例。不过更实用的场景是配合 httpie 的插件生态，比如 httpie-jwt-auth 自动处理JWT令牌刷新。

7. 批量请求（配合 jq）

假设你要批量创建用户，可以把数据做成JSON数组，然后用 jq 循环：

cat users.json | jq -c '.[]' | while read -r user; do
    echo "$user" | http POST https://api.example.com/users
done

8. 调试HTTPS证书问题

http --verify=no https://self-signed.example.com

或者指定CA证书：

http --verify=/path/to/ca.crt https://secure.example.com

为什么我最终抛弃了curl？

不是 curl 不好，而是 httpie 更懂“人”的需求。日常开发中，90%的API调试场景其实不需要 curl 那种“极简主义”的语法。httpie 的彩色输出、自动JSON解析、直观的参数语法，让调试速度至少提升30%。特别是和同事结对编程时，在终端打出 http POST ... 比 curl -X POST -H "Content-Type: application/json" -d '...' 优雅太多了。

当然，如果你需要处理非常底层的HTTP细节（比如原始socket、自定义协议），curl 依然是王者。但对于Web开发、API集成、微服务调试这些日常任务，httpie 绝对是更爽的选择。

最后说一句：装一个不亏，试一次就回不去。赶紧去官网下载体验吧。