メインコンテンツへスキップ
見出し画像

Windows環境へのRustインストールガイド：rustupによるセットアップから開発環境構築まで

    nakaji

    MicrosoftがRustを積極的に採用することから、Rustに興味を持ちました。本記事では、Rust初心者がWindows環境でインストールを行う手順をまとめています。

    なぜRustが選ばれるのかについては、以下の記事で詳しく解説しています：

    目次

    1. Rustとは

    2. インストール前の準備

    3. Rustのインストール方法

    4. インストールの確認

    5. 開発環境のセットアップ

    6. バージョンアップ方法

    7. アンインストール方法

    8. トラブルシューティング

    Rustとは

    Rustは、安全性、並行性、速度を重視したシステムプログラミング言語です。

    主な特徴

    • メモリ安全性: 所有権システムによりメモリ安全性を保証

    • 高速: C/C++と同等のパフォーマンス

    • 並行処理: データ競合を防ぐ設計

    • ゼロコスト抽象化: 高レベルな機能を低コストで提供

    • クロスプラットフォーム: Windows、Linux、macOSで動作

    インストール前の準備

    必要なもの

    1. Visual Studio C++ Build Tools

    Rustのビルドには、Microsoft C++のビルドツールが必要です。

    オプション1: Visual Studio Installer経由

    1. Visual Studioをダウンロード

    2. インストーラーで「C++によるデスクトップ開発」を選択

    3. インストール実行

    オプション2: Build Tools単体

    1. Build Tools for Visual Studioをダウンロード

    2. インストーラーで「C++によるデスクトップ開発」を選択

    3. インストール実行

    2. インターネット接続

    インストール中に必要なコンポーネントがダウンロードされます。

    Rustのインストール方法

    方法1: rustup（推奨）

    rustupはRustの公式インストーラーおよびバージョン管理ツールです。

    ステップ1: rustupのダウンロード

    公式サイトから入手:

    https://rustup.rs/

    または、PowerShellで直接ダウンロード:

    # 64bit版
Invoke-WebRequest -Uri "https://win.rustup.rs/x86_64" -OutFile "$env:TEMP\rustup-init.exe"

# 実行
& "$env:TEMP\rustup-init.exe"

    ステップ2: インストーラーの実行

    1. ダウンロードした `rustup-init.exe` を実行

    2. デフォルト設定でインストールする場合は `1` を入力してEnter

    3. インストールオプションをカスタマイズする場合は `2` を入力

    デフォルトインストール内容:

    • インストール先: `%USERPROFILE%.cargo`

    • Rustツールチェイン: stable

    • ターゲット: x86_64-pc-windows-msvc

    ステップ3: 環境変数の反映

    新しいPowerShell/コマンドプロンプトを開いて、環境変数を反映させます。

    または、現在のセッションで反映:

    $env:Path = [System.Environment]::GetEnvironmentVariable("Path","User") + ";" + [System.Environment]::GetEnvironmentVariable("Path","Machine")

    インストールの確認

    Rustのバージョン確認

    # Rustコンパイラのバージョン
rustc --version

# 出力例: rustc 1.75.0 (82e1608df 2023-12-21)

    Cargoのバージョン確認

    Cargo（カーゴ）はRustのパッケージマネージャーです。

    # Cargoのバージョン
cargo --version

# 出力例: cargo 1.75.0 (1d8b05cdd 2023-11-20)

    インストール先の確認

    # rustcのパス
Get-Command rustc | Select-Object Source

# cargoのパス
Get-Command cargo | Select-Object Source

# インストールディレクトリの確認
# 通常: C:\Users\<ユーザー名>\.cargo
ls $env:USERPROFILE\.cargo

    全ツールの確認

    # インストールされているRustツール一覧
rustup show

    開発環境のセットアップ

    Hello Worldプログラムの作成

    新規プロジェクトの作成

    # プロジェクトディレクトリを作成
cargo new hello_rust
cd hello_rust

    プロジェクト構造

    hello_rust/
├── Cargo.toml      # プロジェクト設定ファイル
└── src/
    └── main.rs     # メインソースファイル

    プログラムの実行

    # ビルドと実行
cargo run

# 出力: Hello, world!

    その他の便利なコマンド

    # ビルドのみ（実行なし）
cargo build

# リリースビルド（最適化あり）
cargo build --release

# コードのチェック（コンパイルせず）
cargo check

# テストの実行
cargo test

# ドキュメントの生成
cargo doc --open

    エディタ・IDEの設定

    Visual Studio Code（推奨）

    1. VS Codeをインストール

    2. 拡張機能をインストール:

      • rust-analyzer（Rust言語サーバー）

      • CodeLLDB（デバッガー）

      • crates（依存関係管理） → Dependi（依存関係管理） ※cratesは非推奨（2025/12/28修正）

    # VS Code拡張機能のインストール
code --install-extension rust-lang.rust-analyzer
code --install-extension vadimcn.vscode-lldb
# code --install-extension serayuzgur.crates  # 非推奨（2025/12/28修正）
code --install-extension fill-labs.dependi    # 推奨: Dependiを使用（2025/12/28修正）

    その他のエディタ

    • IntelliJ IDEA: IntelliJ Rustプラグイン

    • Vim/Neovim: rust.vim

    • Emacs: rust-mode

    バージョンアップ方法

    Rustツールチェインのアップデート

    # 最新版へアップデート
rustup update

# 特定のチャンネルをアップデート
rustup update stable
rustup update nightly

    rustup自体のアップデート

    # rustupのセルフアップデート
rustup self update

    アップデート内容の確認

    # 現在インストールされているツールチェイン
rustup show

# 利用可能なアップデート確認
rustup check

    アンインストール方法

    Rustの完全アンインストール

    # rustupによるアンインストール
rustup self uninstall

    このコマンドで以下が削除されます:

    • Rustツールチェイン

    • Cargo

    • rustup

    • `%USERPROFILE%.cargo`ディレクトリ

    • `%USERPROFILE%.rustup`ディレクトリ

    環境変数の確認

    アンインストール後、必要に応じて環境変数PATHから以下を手動削除:

    %USERPROFILE%\.cargo\bin

    トラブルシューティング

    Visual Studio Build Toolsが見つからない

    エラー:

    error: linker `link.exe` not found

    解決方法:

    1. Visual Studio Build Toolsをインストール

    2. 環境変数が正しく設定されているか確認

    3. PowerShellを再起動

    PATH環境変数が反映されない

    解決方法:

    # 環境変数を再読み込み
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","User") + ";" + [System.Environment]::GetEnvironmentVariable("Path","Machine")

# または、PowerShellを再起動

    ネットワークエラー

    エラー:

    error: could not download file from 'https://...'

    解決方法:

    1. インターネット接続を確認

    2. プロキシ設定がある場合:

    # プロキシの設定
$env:HTTPS_PROXY = "http://proxy.example.com:8080"
$env:HTTP_PROXY = "http://proxy.example.com:8080"

    ディスク容量不足

    Rustツールチェインは約1-2GB必要です。

    確認方法:

    # Cargoのキャッシュサイズ確認
Get-ChildItem -Path "$env:USERPROFILE\.cargo" -Recurse | Measure-Object -Property Length -Sum

# 不要なビルドキャッシュの削除
cargo clean

    ツールチェインの切り替え

    # 利用可能なツールチェインの確認
rustup toolchain list

# デフォルトツールチェインの変更
rustup default stable
rustup default nightly

# プロジェクト単位で指定
rustup override set nightly

    アクセス権限エラー

    管理者権限が必要な場合:

    # PowerShellを管理者として実行
Start-Process powershell -Verb RunAs

    追加情報

    便利なCargoサブコマンド

    # プロジェクトの依存関係確認
cargo tree

# 脆弱性チェック
cargo audit

# コードフォーマット
cargo fmt

# リンター実行
cargo clippy

# ベンチマーク
cargo bench

    クロスコンパイル

    他のプラットフォーム向けにビルド:

    # ターゲット追加
rustup target add x86_64-unknown-linux-gnu

# クロスコンパイル
cargo build --target x86_64-unknown-linux-gnu

    公式リソース

    まとめ

    Windows環境でのRustインストールは、以下の手順で完了します:

    1. ✅ Visual Studio Build Toolsをインストール

    2. ✅ rustup-init.exeをダウンロード・実行

    3. ✅ 環境変数を反映（PowerShell再起動）

    4. ✅ `rustc --version`で確認

    5. ✅ VS Code + rust-analyzerで開発開始

    Rustは強力な言語ですが、学習曲線があります。公式ドキュメントの「The Rust Programming Language」（通称"The Book"）から始めることをお勧めします。

    Happy Coding with Rust! 🦀

    更新履歴

    • 2025/12/28: VS Code拡張機能cratesの非推奨化に伴い、Dependiへの変更を追記

    • 2025/12/27: 新規作成

     
     

    nakaji

     
     
    エンジニア、サイクリスト、アルピニスト

    あなたへのおすすめ