長期使用 curl 或 wget 測試 API 的開發者,常被其繁瑣的參數語法困擾:-H、-d、-X、--data-binary 等選項組合起來極易出錯。HTTPie 以「為人類設計的 HTTP 客戶端」為目標,提供直觀語法、彩色輸出、原生 JSON 支持與會話持久化,大幅提升調試效率。本文涵蓋安裝、核心用法、進階技巧與最佳實踐。
| 系統 | 命令 |
|---|---|
| Debian/Ubuntu/Mint | sudo apt-get install httpie |
| Fedora | sudo dnf install httpie |
| CentOS/RHEL | sudo yum install epel-release && sudo yum install httpie |
| macOS | brew install httpie |
| 通用(Python 環境) | pip install --upgrade httpie |
驗證安裝:http --version → 輸出版本號即成功。
http GET example.org 等價於 http example.org(默認 GET)Header:Value 格式,如 User-Agent:MyApp/1.0field=value(表單)、field:=value(原始 JSON)、field@file(文件上傳)http example.org \
User-Agent:Xmodulo/1.0 \
Referer:https://xmodulo.com \
X-Custom-Header:Foo
# 方式一:重定向輸出
http example.org/large.zip > large.zip
# 方式二:原生下載模式(顯示進度條、自動從 Content-Disposition 取文件名)
http --download example.org/large.zip
http PUT example.org/resource/42 name="Dan Nanni" email=dan@email.com
http DELETE example.org/resource/42
http PATCH example.org/resource/42 status:=archived
http -f POST example.org/login username=admin password=secret
# -f 等同 --form,自動設置 Content-Type
# 直接發送 JSON 對象
http POST api.example.org/users name="Dan Nanni" role:=admin active:=true tags:='["dev","ops"]'
# 從文件讀取 JSON 載荷
http POST api.example.org/import @payload.json
# 從文件讀取請求體
http POST api.example.org/data < request.json
# 管道傳遞動態生成的 JSON
echo '{"name":"Dynamic"}' | http POST api.example.org/data
# 建立會話
http --session=myapi api.example.org/login username=admin password=secret
# 後續請求自動攜帶 Cookie
http --session=myapi api.example.org/dashboard
http --session=myapi api.example.org/settings
# Basic Auth
http -a user:pass example.org/protected
# Bearer Token
http Authorization:"Bearer eyJhbGciOi..." example.org/api
http --help # 完整幫助
http --help=all # 含高級選項
man http # 系統手冊頁
| 選項 | 效果 |
|---|---|
--print=hb | 僅顯示請求頭 + 響應體(調試常用) |
--print=H | 僅顯示請求頭 |
--body | 僅輸出響應體(適合管道傳遞給 jq) |
--headers | 僅輸出響應頭 |
--verbose | 顯示完整通訊過程(含 TLS 握手) |
# 跳過證書驗證(僅測試環境)
http --verify=no https://self-signed.example.org
# 指定客戶端證書
http --cert=client.pem --cert-key=key.pem https://mtls.example.org
# 提取特定字段
http GET api.example.org/users | jq '.[] | select(.role=="admin") | .email'
# 格式化並高亮
http GET api.example.org/data | jq -C . | less -R
對比 curl 的「瑞士軍刀」定位,HTTPie 專注於 開發者體驗:

無論是 REST API 開發、微服務聯調、Webhook 測試,還是日常接口探索,HTTPie 都能讓您專注於業務邏輯而非命令語法。立即替換掉那些寫在便利貼上的 curl 複雜命令吧!