HTTPX
Python 的 HTTP 客户端库,由 encode 维护,同步与异步两套 API 并存,接口布局接近 requests,还能直接向 WSGI/ASGI 应用发请求,适合 Python 开发者写爬虫或调接口时发请求。
3 次可以打开平均 3.5 秒
本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。HTTPX 是给 Python 3 用的 HTTP 客户端库,由 encode 团队维护。它解决的是「在 Python 里发 HTTP 请求」这件事:拿一个 URL 取回状态码、响应头和正文,或者往接口 POST 数据。装好之后几行代码就能跑起来,httpx.get() 返回的响应对象上能直接读 status_code、headers、text。
主要功能
它最常被提起的是同步和异步两套 API 并存。默认写法是同步的,需要并发时切到 async 版本,不用换库。协议上同时支持 HTTP/1.1 和 HTTP/2,HTTP/2 要装 httpx[http2] 这个可选依赖。接口布局大体照着 requests 来,原来用 requests 的代码迁移成本不高,官方也单独写了一页兼容性说明。
其余是 HTTP 客户端的常规能力:连接池与 Keep-Alive、带 Cookie 持久化的 Session、浏览器式 SSL 验证、Basic/Digest 认证、代理、超时、流式下载、分块请求、multipart 文件上传、自动解压和内容解码。它还能直接向 WSGI 或 ASGI 应用发请求,测试 Web 框架时不必真起一个服务器。代码做了完整的类型标注,超时是强制项,不会出现某个请求无限等待的情况。
安装与依赖
用 pip 安装,pip install httpx。要 HTTP/2 就装 httpx[http2],要 brotli 和 zstd 解码就装 httpx[brotli,zstd]。命令行客户端是可选件,装 httpx[cli] 之后可以直接在终端里发请求。底层依赖 httpcore、h11、certifi、idna、sniffio,可选依赖包括 h2、socksio、rich、click 等。运行环境要求 Python 3.9 及以上。
适合谁
写 Python 后端、爬虫、接口对接和自动化脚本的开发者。已经在用 requests、又想上异步或 HTTP/2 的项目,是它比较典型的去处;需要给 Web 框架写测试的人也能用上它直连 ASGI/WSGI 应用的能力。
