Requests

Requests 简介

Requests 是 Python 中最广为人知的 HTTP 客户端库，官方定位是「简单而优雅的 HTTP 库」。它把 HTTP/1.1 请求中繁琐的细节——URL 查询参数拼接、表单编码、JSON 解析、TLS 校验——都收敛到几行直观的代码里。

import requests

r = requests.get('https://httpbin.org/basic-auth/user/pass', auth=('user', 'pass'))
print(r.status_code)   # 200
print(r.json())        # {'authenticated': True, ...}

据官方说明，Requests 每周下载量约 3 亿次，被超过 400 万个仓库依赖，是 Python 生态中事实上的标准 HTTP 工具。

核心特性

• 会话与连接复用：Session 对象保持 Cookie 持久化，并支持 Keep-Alive 与连接池
• 认证支持：Basic、Digest 认证开箱即用
• TLS/SSL 校验：默认启用浏览器风格的证书验证
• 内容处理：自动解压与解码响应内容，r.json() 直接解析 JSON
• 文件上传：支持 multipart 多部分表单上传
• 代理与超时：支持 SOCKS 代理、连接超时设置
• 流式下载：通过 stream=True 分块读取大文件
• 国际化：正确处理国际化域名与 URL

安装与版本

Requests 发布在 PyPI 上，可直接通过 pip 安装：

$ python -m pip install requests

官方目前支持 Python 3.10 及以上版本。

适用与取舍

Requests 采用同步阻塞模型，适合脚本、爬虫、接口调用与自动化测试等场景；若需要异步高并发或 HTTP/2 支持，可考虑 httpx、aiohttp 等替代方案。对于绝大多数日常 HTTP 任务，Requests 依然是上手最快、最稳妥的选择。