第2章環境構築

このガイドを始める前に、Rust 開発環境を整えます。

Rust のインストール

Rust 公式のインストーラを使用します：

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

インストール後、シェルを再起動し、以下で確認します：

rustc --version
cargo --version

プロジェクト作成

新しい Cargo プロジェクトを作成します：

cargo new rust-web-api-tutorial
cd rust-web-api-tutorial

Cargo.toml の設定

Cargo.toml を編集して必要な依存を追加します：

Cargo.toml

[package]
name = "rust-web-api-tutorial"
version = "0.1.0"
edition = "2021"

[dependencies]
tokio = { version = "1.35", features = ["full"] }
axum = "0.7"
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tower = "0.4"
tower-http = { version = "0.5", features = ["trace", "cors"] }
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }

最初のコード

src/main.rs を編集します：

src/main.rs

use axum::{
    routing::get,
    Router,
};
use std::net::SocketAddr;

#[tokio::main]
async fn main() {
    let app = Router::new()
        .route("/", get(hello));
    
    let addr = SocketAddr::from(([127, 0, 0, 1], 3000));
    
    println!("サーバーが起動しました: http://127.0.0.1:3000");
    
    axum::Server::bind(&addr)
        .serve(app.into_make_service())
        .await
        .unwrap();
}

async fn hello() -> &'static str {
    "Hello, Rust Web API!"
}

ビルドと実行

cargo build
cargo run

開発用のホットリロード

開発効率を上げるため、cargo-watch をインストールすると便利です：

cargo install cargo-watch
cargo watch -x run

ファイル変更時に自動的に再ビルド・再実行されます。

別のターミナルで確認：

curl http://127.0.0.1:3000/
# Output: Hello, Rust Web API!

IDEの設定

VS Code + Rust Analyzer がお勧めです：

VS Code をインストール
Rust Analyzer 拡張をインストール
settings.json に以下を追加（オプション）：

{
  "[rust]": {
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "rust-lang.rust-analyzer"
  }
}

これで環境構築が完了しました。第3章「最初のAPI」では、実際に API エンドポイントを実装します。

Introduction - The Cargo Bookdoc.rust-lang.org