http --version

3.2.4

# 确认配置目录初始状态（首次使用前可为空）
ls -la ~/.config/httpie/ 2>/dev/null || echo "配置目录尚未创建"

配置目录尚未创建

mkdir -p ~/.config/httpie
echo '{}' > ~/.config/httpie/config.json

# CLI 选项全量清单（--help 输出 407 行，此处节选高频项）
http --help | grep -E "^\s+--(style|pretty|print|timeout|check-status|ignore-stdin|follow|verify|proxy|session|auth-type|download|output|raw|offline|stream)"

  --raw RAW
  --pretty {all,colors,format,none}
  --style STYLE, -s STYLE
  --response-charset ENCODING
  --print WHAT, -p WHAT
  --all
  --stream, -S
  --output FILE, -o FILE
  --download, -d
  --session SESSION_NAME_OR_PATH
  --session-read-only SESSION_NAME_OR_PATH
  --auth-type {basic,bearer,digest}, -A {basic,bearer,digest}
  --offline
  --proxy PROTOCOL:PROXY_URL
  --follow, -F
  --timeout SECONDS
  --check-status
  --verify VERIFY
  --ignore-stdin, -I

# 运行时环境底座与完整配置状态自检
http --debug --offline httpbin.org/get 2>&1 | head -6

HTTPie 3.2.4
Requests 2.34.2
Pygments 2.21.0
Python 3.12.3 (main, Aug 31 2026, 10:18:26) [GCC 13.3.0]
/root/.local/share/pipx/venvs/httpie/bin/python
Linux 7.0.0-38-generic

cat > ~/.config/httpie/config.json <<'EOF'
{"default_options": ["--style=monokai", "--timeout=15"]}
EOF
cat ~/.config/httpie/config.json

{"default_options": ["--style=monokai", "--timeout=15"]}

# 生效验证：写一个非法 style，让配置解析层报错证明 config 被读取
echo '{"default_options": ["--style=no-such-style"]}' > ~/.config/httpie/config.json
http --ignore-stdin httpbin.org/get

usage:
    http -s/--style {abap, algol, algol_nu, arduino, auto, autumn, borland, bw, 
coffee, colorful, default, dracula, emacs, friendly, friendly_grayscale, fruity,

# 恢复干净配置
echo '{}' > ~/.config/httpie/config.json

# 准备一个独立配置目录
mkdir -p /opt/data/quzuo/tmp/httpie/alt-config
echo '{"default_options":[]}' > /opt/data/quzuo/tmp/httpie/alt-config/config.json

# 正常 JSON：加载成功（无输出即正常）
HTTPIE_CONFIG_DIR=/opt/data/quzuo/tmp/httpie/alt-config http --ignore-stdin --offline httpbin.org/get
echo "exit=$?"

exit=0

# 写入非法 JSON：报 warning 并指明文件路径，证明读取的就是该目录
echo 'not-json' > /opt/data/quzuo/tmp/httpie/alt-config/config.json
HTTPIE_CONFIG_DIR=/opt/data/quzuo/tmp/httpie/alt-config http --ignore-stdin --offline httpbin.org/get

http: warning: invalid config file: Expecting value: line 1 column 1 (char 0) [/opt/data/quzuo/tmp/httpie/alt-config/config.json]

# 恢复
echo '{"default_options":[]}' > /opt/data/quzuo/tmp/httpie/alt-config/config.json

# --print 取值字符：H=请求头 B=请求体 h=响应头 b=响应体 m=元信息；默认 hb
# 只看响应体与耗时元信息：
http --ignore-stdin --print=bm httpbin.org/get

{
  "args": {}, 
  "headers": {
    "Accept": "*/*", 
    "Accept-Encoding": "gzip, deflate", 
    "Host": "httpbin.org", 
    "User-Agent": "HTTPie/3.2.4", 
    "X-Amzn-Trace-Id": "Root=1-6add7ad8-6e9bc9052b6160fb0700ba81"
  }, 
  "origin": "182.54.113.29", 
  "url": "https://httpbin.org/get"
}

Elapsed time: 0.459550006s

# -h / -b 是 --print=h / --print=b 的快捷方式
http --ignore-stdin -h httpbin.org/get

HTTP/1.1 200 OK
Date: Sun, 25 Oct 2026 03:47:14 GMT
Content-Type: application/json
Content-Length: 296

# --proxy 格式为 PROTOCOL:PROXY_URL，可按协议分别指定
# 实测：经内部代理访问 httpbin.org（--print=m 只看是否成功与耗时）
http --ignore-stdin --proxy=http:http://192.168.1.62:7897 --print=m httpbin.org/get

Elapsed time: 0.443759131s

# 代理不可达时的真实报错（实测：连接拒绝）
http --ignore-stdin --print=H --proxy=http:http://182.54.113.29:7897 httpbin.org/get

http: error: ProxyError: HTTPConnectionPool(host='182.54.113.29', port=7897): Max retries exceeded with url: http://httpbin.org/get (Caused by ProxyError('Unable to connect to proxy', NewConnectionError("HTTPConnection(host='182.54.113.29', port=7897): Failed to establish a new connection: [Errno 111] Connection refused"))) while doing a GET request to URL: http://httpbin.org/get

# --timeout 单位秒，支持小数；对慢端点可实测瞬时超时
http --ignore-stdin --timeout=0.001 httpbin.org/delay/3
echo "exit=$?"

http: error: Request timed out (0.001s).

exit=2

# --verify：自签名/内网证书场景，先看默认校验下的真实报错
http --ignore-stdin https://self-signed.badssl.com/ -h

http: error: SSLError: HTTPSConnectionPool(host='self-signed.badssl.com', port=443): Max retries exceeded with url: / (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self-signed certificate (_ssl.c:1000)'))) while doing a GET request to URL: https://self-signed.badssl.com/

# --verify=no 关闭校验后同一端点成功
http --ignore-stdin --verify=no https://self-signed.badssl.com/ -h

HTTP/1.1 200 OK
Server: nginx/1.10.3 (Ubuntu)
Date: Sun, 25 Oct 2026 03:59:53 GMT

# 创建会话：认证信息随首次请求写入会话文件
http --ignore-stdin --session=docs-demo -a admin:q1w2e3r4 https://httpbin.org/basic-auth/admin/q1w2e3r4 > /dev/null

# 会话文件按"主机名"分目录存放
ls ~/.config/httpie/sessions/httpbin.org/

docs-demo.json

cat ~/.config/httpie/sessions/httpbin.org/docs-demo.json

{
    "__meta__": {
        "about": "HTTPie session file",
        "help": "https://httpie.io/docs#sessions",
        "httpie": "3.2.4"
    },
    "auth": {
        "raw_auth": "admin:q1w2e3r4",
        "type": "basic"
    },
    "cookies": [],
    "headers": []
}

# 复用验证：第二条命令不带 -a，Authorization 头自动从会话注入
http --ignore-stdin --session=docs-demo --print=Hh https://httpbin.org/get

GET /get HTTP/1.1
Accept-Encoding: gzip, deflate
Accept: */*
Connection: keep-alive
Authorization: Basic YWRtaW46cTF3MmUzcjQ=
User-Agent: HTTPie/3.2.4
Host: httpbin.org

httpie plugins

usage: httpie [-h] [--debug] [--traceback] [--version] {cli,plugins} ...
httpie: error: Please specify one of these: 'help', 'install', 'upgrade', 'uninstall', 'list'

# 安装一个真实认证插件（JWT）
httpie plugins install httpie-jwt-auth

Using cached httpie_jwt_auth-0.4.0-py2.py3-none-any.whl (6.1 kB)
Installing collected packages: httpie-jwt-auth
Successfully installed httpie-jwt-auth-0.4.0

httpie plugins list

httpie-jwt-auth (0.4.0)
  httpie_jwt_auth (httpie.plugins.auth.v1)

# 卸载
httpie plugins uninstall httpie-jwt-auth

Successfully uninstalled httpie-jwt-auth

{
    "default_options": [
        "--style=monokai",
        "--print=hb",
        "--default-scheme=https"
    ]
}

{
    "default_options": [
        "--ignore-stdin",
        "--check-status",
        "--timeout=15",
        "--pretty=none"
    ]
}

{
    "default_options": [
        "--proxy=http:http://192.168.1.62:7897",
        "--proxy=https:http://192.168.1.62:7897"
    ]
}