⚡ 同步异步一套代码 — 同一个 Client，.get() 是同步，.aget() 是异步，迁移零成本。

🚀 原生 HTTP/2 — 一行配置开启，连接复用、头部压缩，性能与兼容性双提升。

🛡️ 类型友好 — 全面支持类型注解，编辑器补全和静态检查都更顺手。

pip install "httpx[http2]"

import httpx  r = httpx.get("https://www.baidu.com") print(r.status_code)   # 200 print(r.text[:50])     # 响应文本（前 50 个字符） print(r.headers["content-type"])

💡 小技巧：httpx 顶层函数（httpx.get 等）每次都会新建临时连接，仅适合一次性调用。生产环境请务必用下面讲到的 Client 会话复用连接。

import httpx  # 查询参数 r = httpx.get("https://httpbin.org/get", params={"q": "python", "page": 1})  # 表单提交 r = httpx.post("https://httpbin.org/post", data={"user": "alice", "pwd": "123"})  # 发送 JSON（自动序列化 + 设置 Content-Type） payload = {"name": "httpx", "stars": 5} r = httpx.post("https://httpbin.org/post", json=payload)  print(r.json())   # 解析 JSON 响应，等价于 json.loads(r.text)

• params 会自动拼到 URL 上并做 URL 编码，不用自己手拼字符串。

• data 发表单（application/x-www-form-urlencoded），json 发 JSON 并自动设置请求头。

• r.json() 直接拿到解析好的 Python 对象，少写一步 json.loads。

import httpx  # 整体超时 5 秒（连接+读+写都算在内） r = httpx.get("https://httpbin.org/delay/2", timeout=5)  # 更精细地分别设置 timeout = httpx.Timeout(10.0, connect=3.0, read=5.0) r = httpx.get("https://httpbin.org/get", timeout=timeout)

import httpx from tenacity import retry, stop_after_attempt, wait_fixed  @retry(stop=stop_after_attempt(3), wait=wait_fixed(1)) def fetch():     return httpx.get("https://httpbin.org/delay/1", timeout=3)  r = fetch() print(r.status_code)

同步：client.get(url) → 阻塞等待返回。

异步：await client.get(url) → 等待期间让出控制权，事件循环去处理别的任务。

import asyncio import httpx  async def main():     async with httpx.AsyncClient() as client:         # aget 是异步版 get；也可用 await client.get(...)         r = await client.get("https://www.baidu.com")         print(r.status_code)  asyncio.run(main())

import asyncio import time import httpx  urls = [f"https://httpbin.org/delay/1" for _ in range(100)]  async def fetch(client, url):     r = await client.get(url)     return r.status_code  async def main():     async with httpx.AsyncClient() as client:         tasks = [fetch(client, u) for u in urls]         results = await asyncio.gather(*tasks)     return results  start = time.time() codes = asyncio.run(main()) print(f"成功 {len(codes)} 个，耗时 {time.time() - start:.2f}s") # 100 个各延迟 1s 的请求，并发仅需 ≈1s

⚠️ 重要：超高并发会给目标服务造成压力，生产环境记得用 asyncio.Semaphore 控制并发上限（参考上篇 asyncio 教程），做个有礼貌的调用方。

import httpx  with httpx.Client(     headers={"User-Agent": "MyApp/1.0"},     # 公共请求头     cookies={"session": "abc123"},            # 公共 Cookie     auth=("user", "pass"),                     # Basic 鉴权     proxies="http://127.0.0.1:7890",          # 代理     verify=False,                              # 关闭证书校验（慎用）     timeout=10, ) as client:     r = client.get("https://httpbin.org/headers")     print(r.json())

常用鉴权：auth=("user","pass")（Basic）、httpx.Auth 自定义类（Bearer Token 等）。

代理：proxies= 支持 http/https/socks5，科学上网、内网穿透都靠它。

统一配置：Client 级别的参数对所有请求生效，是"优雅封装"的基础（见下文实战）。

import httpx  with httpx.Client(http2=True) as client:     r = client.get("https://www.google.com")     print(r.http_version)   # "HTTP/2"

• limits=httpx.Limits(max_connections=100, max_keepalive_connections=20) — 控制连接池上限。

• 一个 Client 发 100 个请求，底层可能只建了几个连接，省下大量握手时间。

• 同步用 with httpx.Client()，异步用 async with httpx.AsyncClient()，退出时自动释放连接。

import httpx  class HttpClient:     def __init__(self, base_url="", token=None):         headers = {"Accept": "application/json"}         if token:             headers["Authorization"] = f"Bearer {token}"         self._client = httpx.Client(             base_url=base_url,             headers=headers,             timeout=httpx.Timeout(10.0, connect=3.0),             limits=httpx.Limits(max_connections=50),         )      def get_json(self, path, params=None):         r = self._client.get(path, params=params)         r.raise_for_status()           # 非 2xx 自动抛 HTTPStatusError         return r.json()      def post_json(self, path, payload):         r = self._client.post(path, json=payload)         r.raise_for_status()         return r.json()      def close(self):         self._client.close()  # 用法 api = HttpClient(base_url="https://api.example.com", token="xxx") data = api.get_json("/users", params={"page": 1}) api.close()

1. 忘记设超时：即使是 httpx 也建议显式 timeout=，否则个别慢响应会拖垮整体。

2. 异步里用同步 Client：httpx.Client 不能在 async 函数里 await；异步场景必须用 AsyncClient。

3. 每次请求都新建 Client：连接池失效，性能倒退，务必复用同一个 Client 实例。

4. 忽略状态码：先 raise_for_status() 或判断 status_code，别拿到错误页还当成功数据处理。