安装与配置 #

本节将指导你完成Rocket开发环境的搭建，包括Rust工具链的安装和Rocket项目的配置。

前置要求 #

在开始之前，请确保你的系统满足以下要求：

要求	说明
操作系统	Linux、macOS、Windows
Rust版本	1.70.0 或更高
内存	至少 2GB RAM
磁盘空间	至少 5GB 可用空间

安装Rust #

Linux和macOS #

使用rustup安装Rust：

bash

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

安装完成后，重新加载环境：

bash

source $HOME/.cargo/env

Windows #

下载并运行 rustup-init.exe
选择默认安装选项
安装完成后重启终端

验证安装 #

bash

rustc --version
cargo --version

输出示例：

text

rustc 1.75.0 (82e1608df 2023-12-21)
cargo 1.75.0 (1d8b05cdd 2023-11-20)

配置Rust工具链 #

设置默认工具链 #

bash

rustup default stable

更新到最新版本 #

bash

rustup update

安装必要的组件 #

bash

rustup component add clippy rustfmt rust-src

组件	说明
clippy	Rust代码检查工具
rustfmt	代码格式化工具
rust-src	Rust源代码（用于IDE支持）

创建Rocket项目 #

使用Cargo创建项目 #

bash

cargo new my_rocket_app
cd my_rocket_app

添加Rocket依赖 #

编辑 Cargo.toml 文件：

toml

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

[dependencies]
rocket = "0.5"

配置Cargo镜像（中国大陆用户） #

编辑 ~/.cargo/config.toml：

toml

[source.crates-io]
replace-with = 'ustc'

[source.ustc]
registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"

项目配置文件 #

Rocket使用TOML格式的配置文件，支持多环境配置。

创建配置文件 #

在项目根目录创建 Rocket.toml：

toml

[default]
address = "127.0.0.1"
port = 8000
workers = 4
keep_alive = 5
log_level = "normal"

[debug]
address = "127.0.0.1"
port = 8000
log_level = "debug"

[release]
address = "0.0.0.0"
port = 80
workers = 12
log_level = "critical"

配置项说明 #

配置项	说明	默认值
address	监听地址	127.0.0.1
port	监听端口	8000
workers	工作线程数	CPU核心数
keep_alive	Keep-alive超时(秒)	5
log_level	日志级别	normal
secret_key	Cookie加密密钥	随机生成

生成Secret Key #

bash

# 使用openssl生成
openssl rand -base64 32

在配置文件中添加：

toml

[default]
secret_key = "your-generated-secret-key-here"

IDE配置 #

VS Code #

安装推荐扩展：

rust-analyzer - Rust语言服务器
CodeLLDB - 调试支持
Even Better TOML - TOML文件支持
crates - Cargo.toml依赖管理

创建 .vscode/settings.json：

json

{
    "rust-analyzer.checkOnSave.command": "clippy",
    "rust-analyzer.cargo.features": "all",
    "[rust]": {
        "editor.defaultFormatter": "rust-lang.rust-analyzer",
        "editor.formatOnSave": true
    }
}

RustRover #

JetBrains推出的Rust IDE，开箱即用，无需额外配置。

环境变量配置 #

Rocket支持通过环境变量覆盖配置：

bash

# 设置监听地址
export ROCKET_ADDRESS=0.0.0.0

# 设置端口
export ROCKET_PORT=8080

# 设置环境
export ROCKET_PROFILE=debug

在代码中读取环境变量 #

rust

use std::env;

fn main() {
    let port = env::var("ROCKET_PORT").unwrap_or_else(|_| "8000".to_string());
    println!("Server will run on port: {}", port);
}

验证安装 #

创建一个简单的测试程序验证环境配置是否正确。

编辑 src/main.rs：

rust

#[macro_use] extern crate rocket;

#[get("/")]
fn index() -> &'static str {
    "Hello, Rocket!"
}

#[launch]
fn rocket() -> _ {
    rocket::build().mount("/", routes![index])
}

运行项目：

bash

cargo run

访问 http://127.0.0.1:8000，如果看到 “Hello, Rocket!”，说明环境配置成功。

常见问题 #

编译错误：linker ‘cc’ not found #

解决方案（Linux）：

bash

# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo yum groupinstall "Development Tools"

编译速度慢 #

解决方案：

使用更快的链接器：

toml

# .cargo/config.toml
[target.x86_64-unknown-linux-gnu]
linker = "clang"
rustflags = ["-C", "link-arg=-fuse-ld=lld"]

增加并行编译：

bash

export CARGO_BUILD_JOBS=4

Windows编译问题 #

确保安装了：

Visual Studio Build Tools
Windows 10 SDK

下一步 #

环境配置完成后，让我们创建第一个应用，开始Rocket开发之旅。