一、安装 Rust:推荐用 rustup 管理工具链
Rocket 会使用到比较新的 Rust 语言特性,所以需要一个足够新的编译器。官方推荐做法是使用 rustup 来管理 Rust 工具链。
1.1 安装 rustup
步骤很简单:
- 打开 rustup 网站(rustup.rs)
- 按页面提示执行安装命令(不同平台命令略有不同)
安装完以后,在终端里执行:
rustc --version
cargo --version
能看到版本号输出就说明环境正常。
1.2 使用 stable 通道(推荐线上/默认)
Rocket 0.5 已经完全支持稳定版 Rust,最简单的做法就是把默认工具链设置成 stable:
rustup default stable
之后你运行 cargo build / cargo run,都会使用 stable 编译器。
1.3 使用 nightly 通道(推荐本地开发)
虽然 Rocket 在 stable 与 nightly 上都能用,但官方提到:
nightly 工具链在开发体验上会更好,例如更友好的编译报错与诊断信息。
如果你希望在开发时获得更好的提示,可以把默认工具链切到 nightly:
rustup default nightly
一个常见实践是:
- 本地开发:
nightly(提示更详细,查错更轻松) - CI/生产构建:
stable(版本更新节奏更稳)
你可以在不同目录使用 rustup override set xxx 来覆盖默认工具链,这里就不展开。
二、新建一个 Rocket 项目:hello-rocket
环境就绪之后,我们来创建第一个 Rocket 应用。
2.1 创建二进制项目
在命令行执行:
cargo new hello-rocket --bin
cd hello-rocket
--bin 表示创建一个二进制项目(会生成 src/main.rs),这正是我们想要的 Web 服务入口形式。
项目结构大致如下:
hello-rocket
├── Cargo.toml
└── src
└── main.rs
2.2 在 Cargo.toml 中添加 Rocket 依赖
打开项目根目录下的 Cargo.toml,在 [dependencies] 块中添加 Rocket:
[dependencies]
rocket = "0.5.1"

