【環境構築】Rustの開発環境

『rustup』は Rust の公式インストーラ兼バージョン管理ツールです。以下のコマンドでインストールします。

macOS / Linux

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

画面の指示に従ってインストールを進めます。完了したら、ターミナルを再起動するか以下を実行してパスを通します。

source $HOME/.cargo/env

Windows

rustup.rs からインストーラをダウンロードして実行します。Visual Studio の C++ ビルドツールが必要になるため、指示に従ってインストールしてください。

インストールの確認

rustc --version
cargo --version

両方のバージョンが表示されれば、インストールは完了です。

『Cargo』は Rust の公式ビルドツール兼パッケージマネージャです。プロジェクトの作成・ビルド・実行・依存管理をすべて Cargo で行います。

1. プロジェクトを作成します

cargo new hello
cd hello

以下のファイルが自動生成されます。

ファイル	説明
src/main.rs	メインのソースファイルです。
Cargo.toml	プロジェクトの設定と依存関係を記述するファイルです。

2. ソースコードを確認します

自動生成された『src/main.rs』を開くと、以下のコードが書かれています。

fn main() {
    println!("Hello, world!");
}

3. ビルドして実行します

cargo run

『Hello, world!』と表示されれば成功です。『cargo run』はコンパイルと実行を一度に行います。

Cargo を使わず、『rustc』コマンドで直接コンパイルすることもできます。

hello.rs を作成します。

fn main() {
    println!("Hello, World!");
}

rustc hello.rs
./hello

簡単なプログラムの動作確認には便利ですが、依存ライブラリを使う場合は Cargo を使ってください。

コマンド	説明
cargo new プロジェクト名	新しいプロジェクトを作成します。
cargo run	ビルドして実行します。
cargo build	ビルドのみ行います。
cargo build --release	最適化された実行ファイルを生成します。
cargo test	テストを実行します。
cargo fmt	コードをフォーマットします。
cargo clippy	コードの問題点を検出します（リンター）。

ターミナルで『rustc: command not found』や『cargo: command not found』と表示される場合は、PATH（パス）が通っていない可能性があります。以下の手順で確認・設定してください。

1. コマンドの場所を探します

コマンドの場所を確認します。

which rustc
which cargo

見つからない場合、rustup のデフォルトインストール先を確認します。

ls ~/.cargo/bin/rustc
ls ~/.cargo/bin/cargo

2. 使用しているシェルを確認します

echo $SHELL

『/bin/zsh』と表示されたら『~/.zshrc』、『/bin/bash』と表示されたら『~/.bashrc』に設定を書きます。

3. PATH に追加します

rustup でインストールした場合、Rust のコマンドは『~/.cargo/bin/』に配置されます。以下をシェルの設定ファイルに追加してください。

macOS (zsh) の場合:

echo 'source $HOME/.cargo/env' >> ~/.zshrc
source ~/.zshrc

Linux (bash) の場合:

echo 'source $HOME/.cargo/env' >> ~/.bashrc
source ~/.bashrc

『$HOME/.cargo/env』は rustup が自動生成するスクリプトで、PATH の設定を行います。『source』で読み込むと、現在のシェルにすぐ反映されます。

Windows の場合は、rustup のインストーラが自動的に PATH を設定します。反映されない場合はコマンドプロンプトを再起動してください。