Contents
2026年Rust開発環境構築の概要
Rustプロジェクト立ち上げ手順を実践するにあたっては、rustupとVSCodeの組み合わせが2026年の標準的な選択肢です。本記事では、開発環境構築からCI/CDまでの一気通貫ガイドとして、最新ツールチェーンを使ったプロジェクト初期設定を解説します。対象読者であるRust初心者やシステムエンジニア向けに、公式ツール中心の手順を丁寧に記載しています。
rustupによるtoolchainの導入手順
Rust環境構築ではrustupが必須です。 2026年の現在においても、OSごとに最適化されたインストーラーが用意されており、既存ツールとの競合を避けるための手順も整っています。
公式リポジトリからのインストール
rustupはRustの公式パッケージマネージャーであり、以下のようにして導入します。
-
公式サイトから最新バージョンのインストーラーをダウンロード
bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Windowsではrustup-init.exeを実行します。 -
環境変数の設定
インストール後、PATHに~/.cargo/binを追加し、ターミナルでrustc --versionが実行できるか確認します。 -
toolchainの選択とバージョン管理
Rust 1.70以降はstable版がデフォルトとなりますが、必要に応じて以下のように別のバージョンをインストールできます。
bash
rustup install nightly-2026-07
重要: 既存のRust環境と競合しないようにするため、
rustup self uninstallで古いバージョンをアンインストールしておくことが推奨されます。
Cargoプロジェクトのテンプレート作成
Cargo initコマンドで初期構造を作成することで、WASM対応からリファクタリングまでスムーズに進みます。
newコマンドの最新オプション
2026年のcargo newは、以下のようなパラメータが新たに追加されています。
| オプション | 説明 | 例 |
|---|---|---|
--wasm |
WASMターゲット向けの初期設定 | cargo new my_project --wasm |
--lib |
ライブラリプロジェクトを生成 | cargo new --lib math_utils |
--bin |
コマンドラインツールプロジェクトを生成 | cargo new --bin cli_tool |
リファクタリング用の初期構造
以下は、実践的なプロジェクトフォルダ構成例です。
- src/: ソースコード（
main.rsorlib.rs） - tests/: 単体テストファイル
- examples/: 標準ライブラリ使用例
- benches/: パフォーマンステスト用
注意: WASMターゲットを想定する場合は、
Cargo.tomlにcrate-type = ["cdylib"]を追加してください。
VSCodeでのRust開発環境設定
VSCodeの公式拡張機能で安定した開発体験が可能になりました。 非公式な設定は避けて、以下のように導入します。
公式拡張機能の導入手順
- Rust Analyzer拡張機能をインストール
- VSCodeのExtensionsタブから「Rust Analyzer」を検索し、インストールします。
-
リリースノートで最新バージョン（v0.2.13以上）の確認が必須です。
-
ワークスペース設定ファイルの作成
settings.jsonに以下のように追記します：
json
{
"rust-analyzer.checkOnSave": true,
"editor.formatOnSave": true
} -
ターミナルとデバッグの統合
- F5キーでデバッグを開始し、
launch.jsonを自動生成します。 - Rustプロジェクト向けに設定されたデバッガー（LLDB）が自動選択されます。
WASMターゲットへのビルド設定
Rust 1.70以降のWASM関連機能を使い、クロスコンパイルを簡単に実現します。
ターゲットアーキテクチャの指定
cargo buildでWASMターゲットをビルドするには、以下のようにします。
|
1 2 |
cargo build --target wasm32-wasi |
| ターゲット | 説明 | 使用例 |
|---|---|---|
wasm32-wasi |
WebAssembly向けの標準ターゲット（WebAssembly System Interface） | ブラウザやWASI環境で動作 |
wasm32-unknown-unknown |
カスタム実装用（一部機能が制限される） | カスタムランタイム向け |
クロスコンパイル時の注意点
- 依存ライブラリの確認: WASM対応していないライブラリは
[target.wasm32-wasi]で除外する必要があります。
toml
[target.wasm32-wasi]
panic = 'abort'
GitHub ActionsによるCI/CD構築
最新版のGitHub Actions仕様に沿ったワークフロー設定を参考に、WASMビルドも自動化できます。
基本的なワークフロー設定
.github/workflows/ci.ymlに以下の内容を記述します。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
name: Rust CI on: [push, pull_request] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Set up Rust uses:/actions-rs/cargo@v1.0.4 with: rust-version: 1.70 - name: Build and test run: | cargo build --target wasm32-wasi cargo test |
WASMビルドの自動化
WASMのパッケージングはwasm-packやwasm-optを使って最適化します。以下のように追加ステップを設定できます。
|
1 2 3 4 5 |
- name: Package WASM run: | cargo install wasm-pack wasm-pack build --target web |
- 本記事の要点まとめ
- rustupで最新版Rust環境を確実に導入
- Cargo initの最新オプションでプロジェクト構造を作成
- VSCode + Rust Analyzerによる安定した開発体験
- WASMターゲット向けのビルド設定とクロスコンパイル対応
- GitHub ActionsでCI/CDを自動化し、テストとデプロイを一元管理
Rust プロジェクト 立ち上げ 手順に従って最新ツールチェーンで導入することで、効率的な開発が可能になります。