HTTPie: 38,200 GitHub Stars — 现代 CLI HTTP 客户端对比 curl、wget 2026

POST /post HTTP/1.1
Host: pie.dev
X-API-Key: 123
User-Agent: Bacon/1.0
Content-Type: application/x-www-form-urlencoded

name=value&name2=value2

http -f POST pie.dev/post \
    X-API-Key:123 \
    User-Agent:Bacon/1.0 \
    name=value \
    name2=value2

python --version

# 先升级 pip 和 wheel
python -m pip install --upgrade pip wheel

# 安装 HTTPie
python -m pip install httpie

# 验证安装
http --version

brew update
brew install httpie

# 后续升级
brew upgrade httpie

# 添加官方 HTTPie 软件源
curl -SsL https://packages.httpie.io/deb/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/httpie.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/httpie.gpg] https://packages.httpie.io/deb ./" | \
    sudo tee /etc/apt/sources.list.d/httpie.list > /dev/null

# 安装
sudo apt update
sudo apt install httpie

# Fedora
sudo dnf install httpie

# CentOS / RHEL
sudo yum install epel-release
sudo yum install httpie

choco install httpie

# 升级
choco upgrade httpie

# 拉取并运行
docker run --rm httpie/cli https://httpie.io/hello

# 创建 shell 别名便于使用
alias http='docker run --rm -it --net=host httpie/cli'

# 下载独立二进制文件
https --download packages.httpie.io/binaries/linux/http-latest -o http
ln -s ./http ./https
chmod +x ./http ./https

# 直接使用 ./http 和 ./https
./http https://api.example.com/users

$ http https://httpie.io/hello

HTTP/1.1 200 OK
Content-Type: application/json

{
    "message": "Hello, world!"
}

# 从 API 响应中提取特定字段
http GET https://api.github.com/repos/httpie/cli | jq '.stargazers_count, .forks_count'

# 过滤数组结果
http GET https://jsonplaceholder.typicode.com/posts | jq '.[] | {id: .id, title: .title}'

# 将 HTTPie 管道到 jq 再到 HTTPie（API 链式调用）
http GET https://api.github.com/user | jq -r '.login' | http POST example.com/webhook user=@-

#!/bin/bash

# 脚本中始终使用 --ignore-stdin 避免挂起
if http --check-status --ignore-stdin --timeout=2.5 HEAD example.com &> /dev/null; then
    echo '服务正常'
else
    case $? in
        2) echo '请求超时!' ;;
        3) echo '意外重定向!' ;;
        4) echo '客户端错误!' ;;
        5) echo '服务器错误!' ;;
        6) echo '重定向过多!' ;;
        *) echo '其他错误!' ;;
    esac
fi

#!/bin/bash

# 从登录接口存储认证令牌
TOKEN=$(http POST api.example.com/auth username=user password=pass | jq -r '.token')

# 在后续请求中使用令牌
http GET api.example.com/protected "Authorization:Bearer $TOKEN"

#!/bin/bash
# .git/hooks/pre-push — 推送前验证 API 健康状态

http --check-status --timeout=5 --ignore-stdin GET https://api.staging.example.com/health || {
    echo "错误: 预发布 API 不健康。推送已中止。"
    exit 1
}

# .github/workflows/api-test.yml
name: API 健康检查

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 安装 HTTPie
        run: pip install httpie
      - name: 测试 API 端点
        run: |
          http --check-status --timeout=10 GET ${{ secrets.API_URL }}/health
          http --check-status POST ${{ secrets.API_URL }}/users name=Test email=test@example.com

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "测试本地 API",
      "type": "shell",
      "command": "http GET http://localhost:3000/api/health",
      "group": "test"
    }
  ]
}

# 检查集群中所有服务
for service in api-gateway user-service order-service payment-service; do
    http --check-status --timeout=3 GET "http://$service.internal/health" && \
        echo "✓ $service 正常" || echo "✗ $service 失败"
done

# 不发送请求构建请求（离线模式）
http --offline POST api.example.com/v2/users \
    Content-Type:application/json \
    Authorization:"Bearer <token>" \
    name="Jane Doe" \
    email="jane@example.com" \
    role:="['admin', 'editor']" \
    active:=true

# 发送测试 Webhook 负载
http POST https://webhook.site/your-uuid \
    event=order.created \
    order:='{"id": 12345, "total": 99.99, "currency": "USD"}' \
    signature="sha256=abc123..."

# 删除多个资源
for id in $(cat ids.txt); do
    http --check-status DELETE "https://api.example.com/items/$id"
done

# Basic 认证（用户名:密码）
http -a username:password api.example.com/protected

# Basic 认证密码提示（安全）
http -a username api.example.com/protected

# Digest 认证
http -A digest -a username:password api.example.com/protected

# Bearer 令牌认证
http -A bearer -a YOUR_TOKEN api.example.com/protected

# 使用 .netrc 存储凭据
cat ~/.netrc
# machine api.example.com login myuser password mypass
http api.example.com/protected  # 自动使用 .netrc

# 创建带认证和请求头的命名会话
http --session=prod -a user:pass api.example.com/login API-Key:123

# 复用会话 — 认证和请求头自动保留
http --session=prod api.example.com/dashboard

# 只读会话（不会从响应更新）
http --session-read-only=prod api.example.com/data

# 匿名会话（基于文件，跨主机）
http --session=./shared-session.json api.host1.com/data
http --session=./shared-session.json api.host2.com/data

# 跳过 SSL 验证（仅限开发 — 生产环境切勿使用）
http --verify=no https://self-signed.example.com

# 使用自定义 CA 证书包
http --verify=/path/to/ca-bundle.crt https://internal.example.com

# 客户端证书认证
http --cert=client.pem --cert-key=client.key https://mtls.example.com

# 指定 SSL/TLS 版本
http --ssl=tls1.2 https://legacy.example.com

# 自定义密码套件
http --ciphers=ECDHE-RSA-AES128-GCM-SHA256 https://secure.example.com

# 仅显示响应体
http --body GET api.example.com/users

# 仅显示响应头
http --headers GET api.example.com/users

# 详细模式 — 显示完整请求 + 响应
http --verbose PUT api.example.com/users/1 name=Updated

# 超详细模式，含时间元数据
http -vv GET api.example.com/slow-endpoint

# 自定义配色主题
http --style=monokai GET api.example.com/users

# 调试时禁用排序
http --unsorted GET api.example.com/users

# 自定义 JSON 缩进
http --format-options json.indent:2 GET api.example.com/users

# 保存响应到文件
http GET api.example.com/report > report.json

# 带进度条下载（类 wget）
http --download GET api.example.com/files/large-archive.zip

# 命令行内联构建复杂嵌套 JSON
http POST api.example.com/orders \
    customer[name]=Alice \
    customer[email]=alice@example.com \
    items[0][product]=laptop \
    items[0][qty]:=2 \
    items[0][price]:=999.99 \
    items[1][product]=mouse \
    items[1][qty]:=1 \
    items[1][price]:=29.99 \
    shipping[address][street]='123 Main St' \
    shipping[address][city]=Boston \
    shipping[method]=express

# 列出已安装插件
httpie cli plugins list

# 安装认证插件
httpie cli plugins install httpie-jwt-auth
httpie cli plugins install httpie-aws-auth
httpie cli plugins install httpie-ntlm

# 升级插件
httpie cli plugins upgrade httpie-jwt-auth

# 卸载插件
httpie cli plugins uninstall httpie-jwt-auth

# 检查 HTTPie 更新
httpie cli check-updates

// ~/.config/httpie/config.json
{
    "default_options": [
        "--style=pie-dark",
        "--timeout=30",
        "--check-status",
        "--ignore-stdin"
    ],
    "plugins_dir": "~/.config/httpie/plugins"
}

http POST api.example.com/users \
    name="John Doe" \
    age:=29 \
    active:=true \
    roles:='["admin", "editor"]' \
    profile:='{"city": "Boston", "timezone": "EST"}'

# 单次请求代理
http --proxy=http:http://proxy.company.com:8080 api.example.com

# 环境变量
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=https://proxy.company.com:8080
export NO_PROXY=localhost,127.0.0.1

# 表单文件上传
http -f POST api.example.com/upload name="My File" file@~/documents/report.pdf

# 无文件的多部分请求
http --multipart POST api.example.com/data field1=value1 field2=value2

http --pretty=none GET api.example.com/data
# 或设置环境变量
export HTTPIE_NO_COLORS=1