企业官网建设流程全解析

下面是一份2026年最新视角的Python requests 模块全面学习教程，适合零基础到中级开发者。
内容基于requests 2.32.5（2025年8月最新稳定版，支持 Python 3.9+，已放弃 Python 3.8）。

目标：学完后能熟练处理 95% 的 HTTP 场景，包括爬虫、API 调用、文件上传、认证、超时、重试、会话保持等。

1. 安装与快速验证

pipinstallrequests# 推荐（最新版）# 或指定版本（生产环境常用）pipinstallrequests==2.32.5

验证（交互式或脚本）：

importrequestsprint(requests.__version__)# 应该看到 2.32.xr=requests.get("https://httpbin.org/get")print(r.status_code)# 200print(r.json()["url"])# https://httpbin.org/get

2. 核心方法一览（最常用 7 个）

3. 基本使用模板（强烈推荐每次都这样写）

importrequestsfromrequests.exceptionsimportRequestExceptiontry:response=requests.get("https://api.example.com/users",params={"page":1,"limit":20},# 查询参数headers={"User-Agent":"MyApp/1.0"},timeout=10,# 必加！)response.raise_for_status()# 非 2xx 抛异常data=response.json()# 自动解析 JSONprint(data)exceptrequests.Timeout:print("请求超时")exceptrequests.ConnectionError:print("网络连接失败")exceptRequestExceptionase:print(f"请求异常:{e}")

4. 核心属性与方法（Response 对象）

5. 传递参数的 4 种常见方式

# 1. 查询参数（GET 最常用）requests.get("https://httpbin.org/get",params={"q":"python","page":2})# 2. 表单数据（application/x-www-form-urlencoded）requests.post("https://httpbin.org/post",data={"username":"admin","password":"123"})# 3. JSON 数据（Content-Type: application/json）requests.post("https://httpbin.org/post",json={"name":"Alice","age":28})# 4. 文件上传（multipart/form-data）files={"file":open("report.pdf","rb")}requests.post("https://httpbin.org/post",files=files)

6. Headers 与 Cookies 处理

# 自定义 headersheaders={"User-Agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/120","Authorization":"Bearer your_token_here","Accept-Language":"zh-CN,zh;q=0.9",}r=requests.get(url,headers=headers)# 自动管理 cookies（会话内保持）session=requests.Session()session.get("https://example.com/login",data=login_data)r=session.get("https://example.com/profile")# 自动带上登录后的 cookie

7. 超时、重试、代理（生产必备）

# 推荐超时写法（连接超时 + 读取超时）requests.get(url,timeout=(3.05,27))# 连接 3s，读取 27s# 简单重试（推荐用 requests.adapters + urllib3）fromrequests.adaptersimportHTTPAdapterfromurllib3.util.retryimportRetry session=requests.Session()retries=Retry(total=3,backoff_factor=1,status_forcelist=[429,500,502,503,504])session.mount("https://",HTTPAdapter(max_retries=retries))session.mount("http://",HTTPAdapter(max_retries=retries))# 代理（支持 http/https/socks5）proxies={"http":"http://user:pass@proxy_ip:port","https":"http://user:pass@proxy_ip:port",# "all": "socks5://127.0.0.1:1080" # 需要 pip install requests[socks]}requests.get(url,proxies=proxies)

8. 会话（Session） — 性能与状态保持的关键

session=requests.Session()session.headers.update({"User-Agent":"MyBot/1.0"})session.auth=("user","pass")# 基础认证session.cookies.set("theme","dark")# 连接池复用、cookie 自动保持、统一 headers/authforurlinurl_list:response=session.get(url)

9. 认证方式汇总

10. 流式请求与大文件下载

# 流式下载（内存友好）r=requests.get("https://example.com/bigfile.zip",stream=True)withopen("bigfile.zip","wb")asf:forchunkinr.iter_content(chunk_size=8192):ifchunk:f.write(chunk)

11. 常见异常处理全家桶

fromrequests.exceptionsimport(Timeout,ConnectionError,HTTPError,TooManyRedirects,RequestException)try:r=requests.get(url,timeout=8)r.raise_for_status()exceptTimeout:# 重试或切换代理exceptConnectionError:# 网络问题exceptHTTPErrorase:print(f"HTTP 错误:{e.response.status_code}")exceptTooManyRedirects:# 无限重定向exceptRequestExceptionase:# 兜底

12. 进阶推荐方向（学完基础后选修）

• 异步 HTTP：httpx（支持 async/await，API 与 requests 几乎相同）
• 浏览器行为模拟：requests + fake-useragent + cloudscraper（防反爬）
• 重试/限流/熔断：tenacity + requests
• 结构化日志：structlog + requests 的钩子
• mock 测试：responses 或 httpx 的 mock

快速自测清单（学完后能独立完成）

1. 调用带 token 的 GET API 并解析 JSON
2. POST JSON 数据并处理 4xx/5xx
3. 上传单个/多个文件
4. 用 Session 保持登录状态爬取多页
5. 下载大文件不爆内存
6. 设置超时 + 自动重试 3 次
7. 处理代理 + 自定义 UA

如果你能全部实现，恭喜你 requests 已经入门到熟练！

有具体场景想深入（比如反爬、模拟登录、并发下载、结合 pandas 批量调用 API）？告诉我，我给你针对性代码 + 注意事项。加油～