rustlings

カサカサ音?❤️

こんにちは、Rustlings へようこそ。このプロジェクトには、Rust コードの読み書きに慣れるための小さな演習が含まれています。これには、コンパイラ メッセージの読み取りと応答が含まれます。

Rust を学習するための最も包括的なリソースである公式 Rust 本を読むのと並行して、Rustlings の演習を行うことをお勧めします ️

Rust By Example も役立つと思われる推奨リソースです。これには、Rustlings に似たコード例と演習が含まれていますが、オンラインで行われます。

はじめる

Rustのインストール

Rustlings をインストールする前に、最新バージョンの Rust をインストールする必要があります。 Rust のインストール手順の詳細については、www.rust-lang.org/tools/install にアクセスしてください。これにより、Rust のパッケージ/プロジェクト マネージャーであるCargoもインストールされます。

? Linux を使用している場合は、 gcc (リンカー用) がインストールされていることを確認してください。

Deb: sudo apt install gcc 。 Dnf: sudo dnf install gcc 。

? MacOS を使用している場合は、 xcode-select --installを実行して、Xcode とその開発者ツールがインストールされていることを確認してください。

カサカサ音の取り付け

次のコマンドは、Rustling をダウンロードしてコンパイルします。

cargo install rustlings

インストールが失敗した場合… (クリックして展開)

• rustup update実行して、Rust バージョンが最新であることを確認してください
• --lockedフラグを追加してみてください: cargo install rustlings --locked
• それ以外の場合は、問題を報告してください

初期化

Rustlings をインストールした後、次のコマンドを実行してrustlings/ディレクトリを初期化します。

rustlings init

コマンドrustlingsが見つからない場合… (クリックして拡大)

おそらく Linux を使用しており、パッケージ マネージャーを使用して Rust をインストールしていると思われます。

Cargo はバイナリをディレクトリ~/.cargo/binにインストールします。残念なことに、パッケージ マネージャーは~/.cargo/bin PATH環境変数に追加しないことがよくあります。

解決策は…

• ~/.cargo/bin PATHに手動で追加します
• または、パッケージマネージャーからRustをアンインストールし、 rustupを使用した公式の方法を使用してインストールします: https://www.rust-lang.org/tools/install

ここで、新しく初期化されたディレクトリに移動し、Rustlings を起動して、演習を開始するための詳しい手順を確認します。

 cd rustlings/
rustlings

作業環境

エディタ

一般的な推奨事項は、Rust-analyzer プラグインを備えた VS Code です。ただし、Rust-analyzer をサポートするエディタであれば、演習に取り組むのに十分です。

ターミナル

Rustlings を使用するときは、最高のユーザー エクスペリエンスを得るために最新の端末を使用してください。 Linux および Mac のデフォルトのターミナルで十分です。 Windows では、Windows ターミナルをお勧めします。

演習を行う

演習はトピックごとに並べ替えられており、サブディレクトリexercises/<topic>にあります。すべてのトピックには、トピックを開始するためのリソースを含む追加のREADME.mdファイルがあります。始める前に一度ご覧いただくことを強くお勧めします ️

ほとんどの演習にはコンパイルを妨げるエラーが含まれており、それを修正するのはあなた次第です。一部の演習には、演習を実行するために合格する必要があるテストが含まれています ✅

TODOとtodo!()を検索して、変更する必要があるものを見つけます。ウォッチモードでhと入力するとヒントが表示されます

ウォッチモード

初期化後、コマンドrustlings実行するだけで Rustlings を起動できます。

これにより、事前に定義された順序 (初心者にとって最適と考えられる順序) で演習を進めるウォッチ モードが開始されます。 exercises/ディレクトリ内の演習ファイルを変更するたびに、現在の演習が自動的に再実行されます。

exercises/ディレクトリ内のファイル変更の検出に失敗した場合… (クリックして展開)

--manual-runフラグ ( rustlings --manual-run ) を追加すると、監視モードでr入力して現在の演習を手動で再実行できます。

オペレーティング システムに関する情報と、Rustlings をコンテナまたは仮想マシン (WSL など) で実行しているかどうかに関する情報を添えて、問題を報告してください。

エクササイズリスト

ウォッチ モード ( rustlingsの起動後) では、 lと入力して対話型の演習リストを開くことができます。

このリストでは次のことが可能です…

• すべての演習のステータスを確認します (完了または保留中)。
• c : 別の演習を続行します (いくつかの演習を一時的にスキップするか、前の演習に戻ります)
• r : 選択した演習のステータスとファイルをリセットします (後でエディタでファイルをリロード/再度開く必要があります)

使用可能なすべてのキーについては、リストのフッターを参照してください。

質問がありますか?

演習中にヘルプが必要で、組み込みのヒントが役に立たない場合は、質問がまだ行われていない場合は、ディスカッションのQ&Aカテゴリでお気軽に質問してください。

サードパーティの演習

サードパーティの演習は、コミュニティによって維持される一連の演習です。 cargo install rustlingsでインストールしたのと同じrustlingsプログラムを使用して、それらを実行できます。

• 日本語版 Rustlings：Rustlings 演習の日本語訳。

特定のトピックに焦点を当てた独自の Rustlings 演習セットを作成したいですか?それともオリジナルの Rustlings 演習を翻訳したいですか?次に、サードパーティの演習に関するガイドに従ってください。

続きます

Rustlings を完了したら、新しい知識を有効に活用してください。独自のプロジェクトを構築したり、Rustlings に貢献したり、貢献できる他のオープンソース プロジェクトを見つけたりして、Rust スキルを継続的に練習してください。

Rustlings のアンインストール

システムから Rustlings を削除する場合は、次のコマンドを実行します。

cargo uninstall rustlings

貢献する

COTRIBUTING.md を参照してください。

貢献者

素晴らしい貢献者の皆様に感謝します?