Axum安装与环境配置（axie安装教程）

安装Rust开发环境

在开始使用Axum之前，首先需要确保你已经安装了Rust开发环境。Rust是Axum的基础，而Rust开发环境的安装非常简单。以下是安装步骤：

安装Rust

1. 下载Rust安装工具：

Rust的官方安装工具是rustup，它能够帮助你轻松安装和管理Rust的版本。

打开终端（Terminal），执行以下命令：

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

这个命令会从Rust官方网站下载并安装rustup。安装完成后，你会看到类似如下的输出：

Rust is installed now. Great!

2. 配置Rust环境：

安装完成后，需要将Rust的cargo（Rust的包管理工具）和rustc（Rust的编译器）添加到系统的环境变量中。通常，rustup会自动配置，但如果没有，你可以手动添加以下路径到系统的$PATH：

$HOME/.cargo/bin

如果你使用的是macOS或Linux，执行：

source $HOME/.cargo/env

3. 验证安装：

安装完成后，可以使用以下命令检查Rust是否安装成功：

rustc --version

如果安装成功，你应该能看到类似如下的版本号输出：

cargo 1.78.0 (54d8815d0 2024-03-26)

4. 更新Rust：

如果以后需要更新Rust到最新版本，可以使用rustup命令：

rustup update

创建一个新的Axum项目

安装好Rust环境后，就可以开始创建一个新的Axum项目了。以下是创建和配置一个Axum项目的详细步骤：

创建一个新的Rust项目

1. 创建项目目录：

使用cargo命令创建一个新的Rust项目。在终端中执行以下命令：

cargo new axum_project

这会创建一个名为axum_project的新项目目录，目录结构如下：

axum_project/
├── Cargo.toml
└── src/
    └── main.rs

2. 进入项目目录：

进入项目文件夹，准备修改和构建代码：

cd axum_project

3. 配置Cargo.toml

在创建项目后，你需要修改Cargo.toml文件来添加Axum和其他相关依赖。打开Cargo.toml，并在[dependencies]部分添加Axum和其他必需的库。例如：

[package]
name = "axum_project"
version = "0.1.0"
edition = "2021"

[dependencies]
axum = "0.7.9"
serde = { version = "1.0.216", features = ["derive"] }
serde_json = "1.0.133"
tokio = { version = "1.42.0", features = ["full"] }
tower = "0.5.2"

当然比较方便的还是使用cargo add命令来添加依赖，例如:

cargo add axum
cargo add tokio --features full
cargo add serde --features derive
cargo add serde_json
cargo add tower

o axum：是Axum框架的核心库。

o tokio：用于支持异步编程，Axum需要它来运行异步任务。

o serde和serde_json：用于JSON数据的序列化和反序列化。

o tower：提供了用于中间件的基础设施，Axum内部依赖于Tower。

4. 编辑src/main.rs

在src/main.rs文件中，你将编写Web应用的代码。首先，编辑文件以包含Axum的基础代码，创建一个简单的HTTP服务器。

打开src/main.rs，然后替换为以下内容：

use axum::{routing::get, Router};

#[tokio::main]
async fn main() {
    let app = Router::new().route("/", get(|| async { "Hello, Axum!" }));
    let listener = tokio::net::TcpListener::bind("127.0.0.1:9527").await.unwrap();

    println!("Listening on: {}", listener.local_addr().unwrap());
    axum::serve(listener, app).await.unwrap();
}

o Router::new().route("/", get(...))：定义了一个路由，监听根路径/，当收到GET请求时，返回“Hello, Axum!”字符串。

o axum::server(listener, app).await：启动服务器，绑定到指定的IP地址和端口。

5. 运行项目

现在你已经配置好了Axum项目，接下来运行应用程序：

在终端中执行以下命令：

cargo run

执行后，你将看到以下输出：

Listening on: 127.0.0.1:9527

这表示你的Axum服务器已经成功启动并在本地的9527端口上监听。

6. 访问应用

在浏览器中访问 http://127.0.0.1:9527/，你应该能够看到页面显示：

Hello, Axum!

这说明你的Axum应用已经成功运行。

7. 配置代码编辑器

为了提高开发效率，建议使用支持Rust的代码编辑器。以下是一些常见的Rust开发工具和编辑器插件：

1. VSCode：

o 安装Rust插件 rust-analyzer，它可以提供代码补全、跳转、错误提示等功能。

2. IntelliJ IDEA：

o 安装Rust插件 IntelliJ Rust，它也支持代码补全、跳转和调试。

3. RustRover：

o 这是Jetbrains公司最新为Rust开发的一款专属IDE，非商用的话是免费的，对开发者非常的友好。

小结

通过本章的学习，你已经成功安装并配置了Rust开发环境，并创建了一个简单的Axum应用。你现在能够在本地启动Axum服务器并响应HTTP请求。接下来，我们将继续深入学习如何使用Axum处理更多复杂的请求和实现不同功能。