Rust 新手村：10 分钟搞定你的第一个 RESTful API

作者：API传播员 · 2025-11-03 · 阅读时间：4分钟

本教程详细介绍了如何使用Rust语言构建RESTful API，包括Rust环境安装、项目创建、依赖配置以及使用Rocket框架实现简单的GET请求处理。通过具体代码示例展示了如何创建和测试一个返回'你好，世界！'的基础API服务。

一、为什么选 Rust？

速度：编译型语言，零成本抽象，性能接近 C/C++
安全：所有权系统编译期杜绝空指针、悬垂指针
现代：Cargo 一键管理依赖、文档、测试、发布
生态：Rocket、Actix、Warp 等 Web 框架成熟易用

💡 AI 助攻
想自动生成带注释的 Cargo.toml？用「代码生成」提示词，30 秒即可拿到模板，再交给「代码优化」砍掉冗余特性，编译速度提升 20%！

二、环境搭建（1 分钟）

# 安装 Rust 工具链
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

验证：

rustc --version   # ≥ 1.70
cargo --version   # 同 rustc

三、创建项目（10 秒）

cargo new rust_rest_api
cd rust_rest_api

四、依赖配置（30 秒）

Cargo.toml 添加：

[dependencies]
rocket = "0.4.2"
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0.44"
serde_derive = "1.0.104"

五、编写代码（3 分钟）

src/main.rs：

#[macro_use] extern crate rocket;

use rocket::{get, routes};

#[get("/")]
fn index() -> &'static str {
    "你好，世界！"
}

fn main() {
    rocket::ignite()
        .mount("/", routes![index])
        .launch();
}

六、运行与测试（1 分钟）

cargo run
# 默认监听 http://localhost:8000

另开终端：

curl http://localhost:8000
# 输出：你好，世界！

✅ AI 补救
把「curl 测试命令」写进 README 太麻烦？用「代码文档生成器」提示词，自动在函数头部生成标准注释，提醒后续接入 Postman 集合，文档一键达标！

七、进阶路线图（供参考）

阶段	技术点	工具/库
① 路由参数	`#[get("/<name>")]`	Rocket 内置
② JSON 请求/响应	`Json<T>`	`serde`
③ 数据库	SQLite/PostgreSQL	`diesel` / `sqlx`
④ 错误处理	`Result<T, E>`	自定义 `Responder`
⑤ 容器化	多阶段构建	Docker

八、常见 FAQ

Rocket 0.4 与 0.5 差异大吗？
→ 0.5 需要 nightly，语法更简洁；生产请用 0.5，学习可从 0.4 开始。
Windows 能跑吗？
→ 完全支持，安装 Rust 时选 x86_64-pc-windows-msvc 工具链即可。
如何热重载？
→ 安装 cargo-watch：
cargo install cargo-watch
cargo watch -x run
部署到 Linux？
→ cargo build --release 后把二进制 + Rocket.toml 上传即可。

九、下一步行动清单

把示例 push 到 GitHub → 开启 GitHub Actions 自动 cargo test
添加 #[get("/<name>")] 路由 → 体验路径参数
引入 Json<T> → 完成 JSON 请求/响应
用 diesel 连接 SQLite → 实现 CRUD
用 cargo build --release 编译 → 二进制即可分发

今晚就动手，明天就能向小伙伴展示你的 Rust API！🚀

原文链接: https://reintech.io/blog/creating-restful-api-with-rust