用 Rust 构建高性能 Web 应用（Actix-web 入门详细教程）

一、准备工作：安装 Rust 和 Cargo

首先，你需要在你的电脑上安装 Rust 编程语言及其包管理器 Cargo。打开终端并运行以下命令：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装完成后，重启终端或运行 source $HOME/.cargo/env 使环境变量生效。你可以通过以下命令验证是否安装成功：

rustc --versioncargo --version

二、创建第一个 Actix-web 项目

使用 Cargo 创建一个新项目：

cargo new rust-actix-democd rust-actix-demo

接下来，编辑 Cargo.toml 文件，在 [dependencies] 部分添加 Actix-web 依赖：

[dependencies]actix-web = "4.4"

三、编写 Hello World Web 服务

打开 src/main.rs 文件，替换为以下代码：

use actix_web::{web, App, HttpResponse, HttpServer, Result};async fn hello() -> Result {    Ok(HttpResponse::Ok().body("Hello, Rust Actix-web!"))}#[actix_web::main]async fn main() -> std::io::Result<()> {    println!("🚀 服务器启动中... 访问 http://localhost:8080");    HttpServer::new(|| {        App::new().route("/", web::get().to(hello))    })    .bind("127.0.0.1:8080")?    .run()    .await}

这段代码做了三件事：

• 定义了一个异步函数 hello，返回 “Hello, Rust Actix-web!” 字符串。
• 使用 HttpServer::new 创建一个 HTTP 服务器实例。
• 将根路径 / 的 GET 请求绑定到 hello 函数。

四、运行并测试你的 Web 服务

在项目根目录下运行：

cargo run

当看到控制台输出 “🚀 服务器启动中...” 后，打开浏览器访问 http://localhost:8080，你将看到页面显示 “Hello, Rust Actix-web!”。

五、进阶：添加 JSON API 接口

Actix-web 也支持轻松构建 RESTful API。下面是一个返回 JSON 数据的示例：

use actix_web::{web, App, HttpResponse, HttpServer, Result};use serde::{Deserialize, Serialize};#[derive(Serialize)]struct User {    id: u32,    name: String,}async fn get_user() -> Result {    let user = User {        id: 1,        name: "Alice".to_string(),    };    Ok(HttpResponse::Ok().json(user))}#[actix_web::main]async fn main() -> std::io::Result<()> {    HttpServer::new(|| {        App::new()            .route("/user", web::get().to(get_user))    })    .bind("127.0.0.1:8080")?    .run()    .await}

别忘了在 Cargo.toml 中添加 serde 依赖以支持 JSON 序列化：

[dependencies]actix-web = "4.4"serde = { version = "1.0", features = ["derive"] }

现在访问 http://localhost:8080/user 将返回 JSON 格式的用户数据。

总结

通过本教程，你已经掌握了使用 Rust Actix-web 教程 构建基本 Web 服务的核心技能。无论是开发高性能 API 还是传统 Web 应用，Rust Web 开发 都能为你提供坚实的基础。

Actix-web 不仅性能卓越，而且文档完善、社区活跃，是学习 高性能 Rust Web 框架 的理想起点。希望这篇 Actix-web 入门指南 能帮助你迈出 Rust 后端开发的第一步！

继续探索，用 Rust 构建更快、更安全的 Web 未来！