### Requests库基础用法教程 Requests 是 Python 中用于处理 HTTP 请求的一个第三方库，它提供了简单易用的 API 来发送各种类型的网络请求。以下是关于 Requests 库的一些基础知识和常见用法。 #### 导入模块 在使用 Requests 库之前，需要先安装并导入该模块。可以通过以下命令来完成： ```bash pip install requests ``` 随后，在代码中通过 `import` 关键字引入此模块[^1]。 ```python import requests ``` --- #### 发送 GET 请求 GET 请求通常用来从服务器获取数据。可以指定 URL 和查询参数 (query parameters)，并通过 `.get()` 方法实现。下面是一个简单的例子： ```python # 定义目标URL和查询参数 req_url = "http://example.com/api/data" req_params = {"key": "value"} # 发起GET请求 resp = requests.get(url=req_url, params=req_params) # 获取状态码和响应体 print(f"Status Code: {resp.status_code}") # 输出HTTP状态码 print(f"Response Body:\n{resp.text}") # 打印返回内容 ``` 上述代码展示了如何构建带参数的 GET 请求，并打印其结果[^3]。 --- #### 发送 POST 请求 POST 请求主要用于向服务器提交数据或者上传文件。可以通过设置 `data` 参数传递表单数据；如果涉及大文件传输，则推荐借助 **requests-toolbelt** 实现流式上传功能[^2]。 ##### 提交表单数据 当需要模拟 HTML 表单提交操作时，可利用如下方法： ```python post_data = {'username': 'admin', 'password': 'secret'} response_post = requests.post('https://httpbin.org/post', data=post_data) print(response_post.json()) # 将JSON格式字符串转换成Python字典显示更直观的结果 ``` ##### 文件上传 对于文件上传场景，需准备要传送的目标文档路径以及对应的 MIME 类型等信息： ```python upload_file_path = './sample.txt' with open(upload_file_path, mode='rb') as file_obj: response_upload = requests.post( url="https://httpbin.org/post", files={'uploaded_file': ('new_name_for_sample.txt', file_obj)} ) print(response_upload.content.decode()) ``` 注意这里采用了上下文管理器 (`with`) 自动关闭打开后的文件句柄。 --- #### 处理响应对象 无论哪种类型的请求完成后都会得到一个 Response 对象实例，其中包含了丰富的属性供开发者分析或进一步加工。常用字段列举如下： - `status_code`: 返回的状态码； - `headers`: 响应头集合； - `text`: 解析后的纯文本形式主体部分； - `json()`: 当确认服务端回传的是合法 JSON 数据结构时调用此函数解析为 Python 字典型变量[^4]。 示例演示读取响应头部信息的过程： ```python res_headers = resp.headers for k, v in res_headers.items(): print(k + ": ", v) ``` --- #### 设置超时时间与时限控制 为了避免因网络状况不佳而导致程序卡死的情况发生，建议每次发起请求前都设定合理的 timeout 时间阈值（单位秒）。一旦超过限定范围还未收到回复则抛出异常中断流程继续执行后续逻辑分支。 ```python try: result_with_timeout = requests.get("http://slowapi.example/", timeout=(5, None)) except Exception as e: print(e.__class__.__name__, str(e)) else: print(result_with_timeout.url) finally: pass ``` 此处 `(connect_timeout, read_timeout)` 的含义分别代表连接建立阶段耗时上限与实际接收全部数据所需最大等待时限。 ---