インストール

最初のステップは Rust をインストールすることです。rustup を通じて Rust をダウンロードします。rustup は、Rust のバージョンと関連ツールを管理するためのコマンドラインツールです。ダウンロードにはインターネット接続が必要です。

注: 何らかの理由で rustup を使いたくない場合は、より多くの選択肢について その他の Rust のインストール方法のページ を参照してください。

以下の手順では、Rust コンパイラの最新の安定版をインストールします。Rust の安定性保証により、この本の中でコンパイルできるすべての例は、より新しい Rust のバージョンでも引き続きコンパイルできます。出力はバージョンによってわずかに異なる場合があります。これは、Rust がエラーメッセージや警告をしばしば改善しているためです。言い換えると、これらの手順を使ってインストールした新しい安定版の Rust であれば、この本の内容は期待どおりに動作するはずです。

コマンドライン表記

この章および本書全体を通して、ターミナルで使用するいくつかのコマンドを示します。ターミナルに入力すべき行は、すべて $ で始まります。$ 文字そのものを入力する必要はありません。これは各コマンドの開始を示すために表示されるコマンドラインプロンプトです。$ で始まらない行は、通常、前のコマンドの出力を示します。さらに、PowerShell 固有の例では $ ではなく > を使用します。

Linux または macOS への rustup のインストール

Linux または macOS を使用している場合は、ターミナルを開いて次のコマンドを入力してください。

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

このコマンドはスクリプトをダウンロードし、最新の安定版 Rust をインストールする rustup ツールのインストールを開始します。パスワードの入力を求められることがあります。インストールが成功すると、次の行が表示されます。

Rust is installed now. Great!

また、リンカー も必要です。これは Rust がコンパイル済みの出力を 1 つのファイルに結合するために使うプログラムです。おそらく、すでに 1 つは入っているはずです。リンカーエラーが出た場合は、C コンパイラをインストールしてください。通常、C コンパイラにはリンカーが含まれています。一般的な Rust パッケージの中には 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 のインストールを求められます。これにより、プログラムのコンパイルに必要なリンカーとネイティブライブラリが提供されます。この手順でさらに助けが必要な場合は、 https://rust-lang.github.io/rustup/installation/windows-msvc.html を参照してください。

この本の残りの部分では、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（私たちが自分たちを呼ぶ、ちょっとふざけた愛称）と連絡を取る方法を確認してください。

更新とアンインストール

rustup を使って Rust をインストールした後は、新しくリリースされたバージョンへの更新は簡単です。シェルから、次の更新スクリプトを実行してください。

$ rustup update

Rust と rustup をアンインストールするには、シェルから次のアンインストールスクリプトを実行してください。

$ rustup self uninstall

ローカルドキュメントを読む

Rust のインストールには、ドキュメントのローカルコピーも含まれているので、オフラインで読むことができます。rustup doc を実行すると、ブラウザでローカルドキュメントが開きます。

型や関数が標準ライブラリによって提供されていて、それが何をするのか、どう使うのかがわからないときはいつでも、アプリケーションプログラミングインターフェース（API）ドキュメントを使って調べてください！

テキストエディタと IDE の使用

この本では、Rust コードを書くためにどのツールを使うかについて何も前提としていません。ほとんどどんなテキストエディタでも十分に作業できます。ただし、多くのテキストエディタや統合開発環境（IDE）には Rust の組み込みサポートがあります。Rust の Web サイトにある ツールページ では、多くのエディタと IDE の比較的新しい一覧をいつでも確認できます。

この本をオフラインで使う

いくつかの例では、標準ライブラリ以外の Rust パッケージを使用します。そうした例を進めるには、インターネット接続が必要になるか、あるいはそれらの依存関係を事前にダウンロードしておく必要があります。依存関係を事前にダウンロードするには、次のコマンドを実行できます。（cargo が何であるか、またこれらの各コマンドが何をするかについては、後で詳しく説明します。）

$ cargo new get-dependencies
$ cd get-dependencies
$ cargo add rand@0.8.5 trpl@0.2.0

これにより、これらのパッケージのダウンロードがキャッシュされるので、後でダウンロードする必要がなくなります。この一連のコマンドを実行したら、get-dependencies フォルダーを残しておく必要はありません。この一連のコマンドを実行していれば、この本の残りの部分にあるすべての cargo コマンドで --offline フラグを使い、ネットワークを使おうとする代わりに、これらのキャッシュされたバージョンを使用できます。