🦾

開発環境: WindowsにRust(MSVC)の開発環境を構築する (2023年版)

2023/07/17に公開

tl;dr

Rust^[1]開発のためには、Visual Studio Build Tools^[2]をインストールが必要
環境変数を設定し、それに基づいてRustをインストールする
これらの手順は、wingetコマンドを用いて効率的に行える

はじめに

プログラミング言語Rustを使用するためには、ソースのコンパイル／ビルド用にC++コンパイラが必須です。
Windows版Rust ではVisual C++か、もしくはGNU C++が求められます。
このため、Rust をインストールする前に C++の開発環境をセットアップする必要があります。

この記事では、Visual C++コンパイラを含む Microsoftのソフトウェア開発ツール、Visual Studio Build Tools`をあらかじめインストールしておきます。

Rust および Visual Studio Build Tools のインストールは、winget^[3] コマンドで簡単に行えます。
wingetは Windows の公式パッケージマネージャーで、ソフトウェアのインストールをコマンドラインから一括で行えます。
この記事では、RustとVisual Studio Build Toolsのインストール方法をステップバイステップで説明します。

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

Rust が正常に動作するためには、C++コンパイラが必要です。Rustを使うため、事前に、C++コンパイラを含む Microsoft のソフトウェア開発ツール、Visual Studio Build Toolsをインストールしておきます。

詳しい説明は、"Visual Studio Build Toolsのインストール手順ガイド"を見てください。

1.1. Visual Studio Build Toolsをインストールする

次の手順で、Visual Studio Build Toolsをインストールします。

Visual Studio Installerの起動:
下記のコマンドを実行し、Visual Studio Installerを起動する
```
winget install Microsoft.VisualStudio.2022.BuildTools
```
コンポーネントの選択:
[コンポーネントの選択]画面で、[C++によるデスクトップ開発]を選択する
Build Toolsのインストール:
[インストール]ボタンをクリックし、選択したコンポーネントをインストールする
Visual Studio Installerの終了:
右上の[×]をクリックし、インストーラーを終了する

これでVisual Studio Build Toolsのインストールは完了です。
次に、Visual Studio Build ToolsのPathを設定します。

1.2. Pathを設定する

次の手順で、Pathを設定します。

[システムのプロパティ]ダイアログを開く:
下記のコマンドを実行する
```
systempropertiesadvanced.exe
```
[システムのプロパティ]ダイアログが表示される
[環境変数]ダイアログを開く:
[環境変数]ボタンをクリックする。[環境変数]ダイアログが表示される
[システム環境変数]のPathを編集:
"システム環境変数"のPathを選び、[編集(I)]をクリックする。
[システムの環境変数]ダイアログが表示される
C++コンパイラのパスを追加:

[新規]をクリックし、以下のPathを追加する

Path 概要

C:/Program Files (x86)/Microsoft Visual Studio/2022/BuildTools/VC/Tools/MSVC/14.36.32532/bin/HostX64/x64 C++コンパイラ
ダイアログの終了:
[OK]をクリックし、すべてのダイアログを終了する
PC の再起動
設定したPathを環境に反映させるため、PC を再起動する

Path	概要
`C:/Program Files (x86)/Microsoft Visual Studio/2022/BuildTools/VC/Tools/MSVC/14.36.32532/bin/HostX64/x64`	`C++`コンパイラ

以上で、Visual Studio Build Toolsのセットアップは完了です。

2. Rust のインストール

2.1. 環境変数の設定

以下に、Rustのインストールおよび動作に関する環境変数をしめします。これらの変数をインストール前に設定することで、インストール先などを指定できます。
以下に、Rustが使用する環境変数とその設定を載せておきます。

環境変数	概要	備考
`CARGO_HOME`	`Cargo`のインストール先	`Rust`のパッケージマネージャー`Cargo`のインストール先。`Rust`コンパイラなども、このディレクトリ下に保存する
`Path`	`Rust`ツールパス	`Rust`の各種ツールを実行するための`Path`を追加する
`RUSTUP_HOME`	`Rust`用各種データ保存先	Rustのツールチェーン、コンパイラの実体や、C用のヘッダー、ライブラリなど各種データを保存する

環境変数を設定する

次の手順で、環境変数を設定します。

[システムのプロパティ]ダイアログを開く:
下記のコマンドを実行する
```
systempropertiesadvanced.exe
```
[システムのプロパティ]ダイアログが表示される
[環境変数]ダイアログを開く:
[環境変数]ボタンをクリックする。[環境変数]ダイアログが表示される
[システム環境変数]の編集:
"システム環境変数"に以下の環境変数を設定する

環境変数設定備考

CARGO_HOME c:\lang\rust 自分の環境では、c:\lang下に各種言語が入る

Path %CARGO_HOME%\bin Pathに左記の設定を追加する
[ユーザー環境変数]の編集:
"システム環境変数"に以下の環境変数を設定する

環境変数設定備考

RUSTUP_HOME %XDG_DATA_HOME%\rustup XDG Base Directory^[4]に対応
ダイアログの終了:
すべてのダイアログの[OK]をクリックし、ダイアログを終了する
PC の再起動:
設定したPathを環境全体に反映させるため、PC を再起動する

環境変数	設定	備考
`CARGO_HOME`	`c:\lang\rust`	自分の環境では、`c:\lang`下に各種言語が入る
`Path`	`%CARGO_HOME%\bin`	`Path`に左記の設定を追加する

環境変数	設定	備考
`RUSTUP_HOME`	`%XDG_DATA_HOME%\rustup`	`XDG Base Directory`^[4]に対応

以上で、環境変数の設定は完了です。

2.2. Rustをインストールする

Rustを公式サイトからインストールする際には、Rust toolchainのインストーラーであるRustup^[5]を使用します。
Rustupはcargoやそのほかの Rust でのソフトウェア開発に必要なツールチェーンも一緒にインストールします。
Rust開発環境全体の管理・構築・アップデートができるツールです。

wingetのパッケージにはRust言語とそのインストーラーRustupのパッケージが含まれています。
今回は、Rustupを使用するためにrustupパッケージをインストールします。

下記に、winget内のRust言語関連のパッケージをまとめています。

`パッケージID`	説明	備考
`Rustlang.Rustup`	`The Rust toolchain installer`	`Rustup`のインストーラー。Rust はインストールされた`rustup`によって、自動的にインストールされる
`Rustlang.Rust.MSVC`	`Rust (MSVC)`	Rust言語、C/C++モジュールに `VIsual C++` を使用する版
`Rustlang.Rust.GNU`	`Rust (GNU)`	Rust言語、C/C++モジュールに`GNU C++`を使用する版

次の手順で、Rustをインストールします。

rustup のインストール:
Windows Terminalで次のコマンドを実行し、Rustupをインストールする
```
winget install rustlang.rustup
```

Rust のインストール:
rustupが自動的に実行され、rustをインストールする

rustup

info: profile set to 'default'
info: default host triple is x86_64-pc-windows-msvc
info: syncing channel updates for 'stable-x86_64-pc-windows-msvc'
 .
 .
 ,

以上で、rust のインストールは完了です。

2.3. Rustの動作チェック

インストールが正常に終了していれば、Rustコンパイラrustcが使用可能です。
次の手順で、rustcの動作をチェックします。

rustcのバージョン ;
Windows Terminalで次のコマンドを実行する
```
rustc --version
```
バージョンのチェック:
Terminalに次のようなバージョン番号が表示されるかチェック
```
rustc 1.71.0 (8ede3aae2 2023-07-12)
```

( rustc 1.71.0 ...) のようなバージョン番号が表示されれば、Rustは正常にインストールされています。

3. 開発環境の確認

Rustを正常にインストールし、Rust によるプログラミングができることを確認するためにHello,Worldを出力する簡単なプログラムを作成します。

3.1. Rustで`Hello, World`

次の手順で、Rust の開発環境を確認します。

作業用ディレクトリに移動:
PowerShellを開き、プログラミング用の適当な作業用ディレクトリに移動する
```
cd ~/workspacies/temp/rust
```
hello.rsの作成:
hello.rsファイルを作成し、ファイルに以下のRustコードを記述する
```
// hello.rs
 fn main()
 {
    println!("Hello, rust World!")
}
```
hello.exeの作成:
hello.rsをコンパイルしてhello.exeを作成する
```
 rustc hello.rs
```
hello.exe の実行:
hello.exeを実行し、正常に動作するかを確認する
```
Hello, rust World!
```

上記のように"Hello, rust World!"が出力されていれば、Rustは正常に動作しています。

さいごに

以上の手順で、Windows 環境に MSVC版Rust をインストールできます。
まとめると、以下の主要なステップで Rust のインストールが可能です。

Rustのインストール前に、C++コンパイラを含む"Visual Studio Build Tools"をインストールします
環境変数を事前に設定すれば、Rust のインストール先などを自由に変更できます
wingetコマンドを使うことで、簡単に Rustをインストールします

これらのステップを実行すれば、スムーズにRustの開発環境が構築できます。

今回の記事を参考に、Rust の開発環境構築を進めてみてください。そして新たに手にした Rust の力を活用し、あなたのエンジニアリングの世界をさらに広げてみてください。

それでは、Happy hacking!

参考資料

Webサイト

脚注

Rust: 高速で安全性が高く、並行性と実用性を兼ね備えたシステムプログラミング言語。その特徴として、メモリ安全性の維持と高速性を両立した設計があげられる。 ↩︎
Visual Studio Build Tools: マイクロソフトが提供するクロスプラットフォーム用のソフトウェア開発ツール。Rust のインストールにはこれが必要となる。 ↩︎
winget: WIndows 公式のパッケージマネージャー ↩︎
XDG Base DIrectory: Linux/UNIX で設定ファイルを保存するときに用いられる標準的なディレクトリ仕様 ↩︎
Rustup: Rust開発環境を構築、管理する公式のツール。Rust言語の開発環境を構築する際には、rustup の使用が推奨されている。 ↩︎

GitHubで編集を提案