インストール
最初の手順は、Rustをインストールすることです。Rustは、Rustのバージョンと関連するツールを管理する、rustupというコマンドラインツールを使用してダウンロードします。ダウンロードには、インターネットへの接続が必要になります。
注釈: なんらかの理由で
rustupを使用したくない場合、Other Rust Installation Methods ページで、 他の選択肢をご覧になってください。
以下の手順で最新の安定版のRustコンパイラをインストールします。 Rustは安定性 (stability) を保証しているので、現在この本の例でコンパイルできるものは、新しいバージョンになってもコンパイルでき続けることが保証されます。 出力は、バージョンによって多少異なる可能性があります。Rustは頻繁にエラーメッセージと警告を改善しているからです。 言い換えると、どんな新しいバージョンでもこの手順に従ってインストールした安定版なら、 この本の内容で想定通りに動くはずです。
コマンドラインの記法
この章及び、本を通して、端末で使用するなんらかのコマンドを示すことがあります。読者が入力するべき行は、 全て
$で始まります。ただし、読者が$文字を入力する必要はありません; これは各コマンドの開始を示すために表示しているコマンドラインプロンプトです。$で始まらない行は、典型的には直前のコマンドの出力を示します。また、PowerShell限定の例には、$ではなく、>を使用します。
LinuxとmacOSにrustupをインストールする
LinuxかmacOSを使用しているなら、端末（ターミナル）を開き、以下のコマンドを入力してください:
$ curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh
このコマンドはスクリプトをダウンロードし、rustupツールのインストールを開始し、Rustの最新の安定版をインストールします。
パスワードを求められる可能性があります。インストールがうまく行けば、以下の行が出現するでしょう:
Rust is installed now. Great!
リンカも必要になるでしょう。 リンカは、コンパイルされた出力をひとつのファイルに合体させるためにRustが使用するプログラムです。 リンカが既にインストールされている可能性は高いでしょう。 リンカエラーが発生したときは、Cコンパイラは典型的にリンカを含んでいるでしょうから、Cコンパイラをインストールすべきです。 一般的なRustパッケージの中には、Cコードに依存し、Cコンパイラが必要になるものもあるので、この理由からもCコンパイラは有用です。
macOSでは、以下を実行することでCコンパイラが手に入ります:
$ xcode-select --install
Linuxユーザは、通常はディストリビューションのドキュメントに従って、GCCまたはClangをインストールするべきです。
例えばUbuntuを使用している場合は、build-essentialパッケージをインストールすれば大丈夫です。
Windowsでrustupをインストールする
Windowsでは、https://www.rust-lang.org/tools/installに行き、手順に従ってRustをインストールしてください。 インストールの途中で、Visual Studio 2013以降用のMSVCビルドツールも必要になるという旨のメッセージが出るでしょう。
ビルドツールを取得するには、Visual Studio 2022をインストールする必要があるでしょう。 どのワークロード (workloads) をインストールするかと質問されたときは、以下を含めてください:
- 「C++によるデスクトップ開発」(“Desktop Development with C++”)
- Windows 10または11のSDK
- 英語の言語パック (English language pack) コンポーネント (お好みで他の任意の言語パックも)
訳注：Windowsの言語を日本語にしている場合は言語パックのところで「日本語」が選択されており、そのままの設定でインストールしても基本的に問題ないはずです。しかし、サードパーティーのツールやライブラリの中には英語の言語パックを必要とするものがあるため、「日本語」に加えて「英語」も選択することをお勧めします。
これ以降、cmd.exeとPowerShellの両方で動くコマンドを使用します。 特段の違いがあったら、どちらを使用すべきか説明します。
トラブルシューティング
Rustが正常にインストールされているか確かめるには、シェルを開いて以下の行を入力してください:
$ rustc --version
リリース済みの最新の安定版のバージョンナンバー、コミットハッシュ、コミット日が以下の形式で表示されるはずです。
rustc x.y.z (abcabcabc yyyy-mm-dd)
この情報が見られたなら、Rustのインストールに成功しています！
この情報が出ない場合は、次のようにしてRustが%PATH%システム環境変数にあることを確認してください。
Windows CMDでは:
> echo %PATH%
PowerShellでは:
> echo $env:Path
LinuxおよびmacOSでは:
$ echo $PATH
これらが全て正常であるのに、それでもRustがうまく動かないなら、助力を得られる場所はたくさんあります。 他のRustacean（Rustユーザが自分たちのことを呼ぶ、冗談めいたニックネーム）たちと交流する方法をコミュニティページで探してください。
訳注1：Rustaceanについて、いらないかもしれない補足です。公式Twitter曰く、Rustaceanはcrustaceans（甲殻類）から来ているそうです。 そのため、Rustのマスコットは（非公式らしいですが）カニ。上の会話でCの欠点を削ぎ落としているからcを省いてるの？みたいなことを聞いていますが、 違うそうです。検索したら、堅牢性が高いから甲殻類という意見もありますが、真偽は不明です。 明日使えるかもしれないトリビアでした。
訳注2：上にあるコミュニティページはどれも英語話者のコミュニティへのリンク集です。日本語話者のためのコミュニティがZulip rust-lang-jpにあり、こちらでもRustaceanたちが活発に議論をしています。 公式Discord同様、初心者向けの#beginnersチャンネルが存在するので、気軽に質問してみてください。
更新及びアンインストール
rustup経由でRustがインストールされたなら、新しくリリースされた版へ更新するのは簡単です。
シェルから以下の更新スクリプトを実行してください:
$ rustup update
Rustとrustupをアンインストールするには、シェルから以下のアンインストールスクリプトを実行してください:
$ rustup self uninstall
ローカルのドキュメンテーション
インストールされたRustには、オフラインでドキュメンテーションを閲覧できるように、ドキュメンテーションのローカルコピーが含まれています。
ブラウザでローカルのドキュメンテーションを開くには、rustup docを実行してください。
標準ライブラリにより提供される型や関数がなんなのかや、それをどう使えば良いのかがよくわからないときは、いつでもAPIのドキュメンテーションを検索してみてください！