Rust语言reqwest HTTP客户端详解（从零开始掌握Rust网络请求）

什么是 reqwest？

reqwest 是一个基于 tokio 和 hyper 构建的Rust HTTP客户端库，支持同步和异步两种模式。它提供了简洁的API，让你可以轻松地发送GET、POST等请求，并处理响应数据。作为 Rust网络请求库 的代表之一，reqwest被广泛用于爬虫、微服务通信、API调用等场景。

准备工作：创建Rust项目并添加依赖

首先，确保你已经安装了Rust（推荐使用 rustup 安装）。然后创建一个新的项目：

cargo new rust_reqwest_democd rust_reqwest_demo

接下来，在 Cargo.toml 文件中添加 reqwest 依赖。如果你要使用异步功能（推荐），还需要启用 tokio 运行时：

[dependencies]reqwest = { version = "0.11", features = ["json"] }tokio = { version = "1", features = ["full"] }

这里我们启用了 json 特性，以便后续能方便地处理JSON数据。

示例1：发送异步GET请求

在 src/main.rs 中编写以下代码：

use reqwest;#[tokio::main]async fn main() -> Result<(), reqwest::Error> {    let resp = reqwest::get("https://httpbin.org/get")        .await?;    println!("Status: {}", resp.status());    let body = resp.text().await?;    println!("Body:\n{}", body);    Ok(())}

运行命令 cargo run，你将看到从 httpbin.org 返回的响应内容。这段代码展示了如何使用 异步HTTP请求 获取网页内容。

示例2：发送POST请求并发送JSON数据

很多时候我们需要向服务器提交数据。下面是一个发送JSON格式POST请求的例子：

use reqwest;use serde_json::json;#[tokio::main]async fn main() -> Result<(), reqwest::Error> {    let client = reqwest::Client::new();    let res = client        .post("https://httpbin.org/post")        .json(&json!({            "name": "Alice",            "age": 30        }))        .send()        .await?;    let status = res.status();    let body = res.text().await?;    println!("Status: {}", status);    println!("Response:\n{}", body);    Ok(())}

注意：这里我们使用了 serde_json 来构造JSON对象。你可能需要在 Cargo.toml 中添加：

serde_json = "1.0"

同步请求（可选）

虽然异步是主流，但reqwest也支持同步请求（需启用 blocking 特性）：

// Cargo.toml 中添加 features = ["blocking"]// use reqwest::blocking;fn main() -> Result<(), reqwest::Error> {    let resp = blocking::get("https://httpbin.org/get")?;    println!("Status: {}", resp.status());    println!("Body: {}", resp.text()?);    Ok(())}

总结

通过本教程，你已经学会了如何使用 reqwest —— 一个功能强大的 Rust Web开发 必备工具。无论是获取网页、调用REST API，还是上传文件，reqwest都能胜任。希望你能将这些知识应用到自己的项目中，构建出高效、可靠的网络应用！

记住我们的四个核心 SEO关键词：

• Rust reqwest HTTP客户端
• Rust网络请求库
• 异步HTTP请求
• Rust Web开发