クレートとクレートルート
プロジェクト構成
「クレートとクレートルート」はCoddyKit上の無料Learn Rust Codingレッスンです。 これはレッスン4/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはLearn Rust Coding学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Learn Rust Codingコースには全4レッスンが含まれています。
クレートとは
クレートは、Rustコンパイラーが扱う最小単位です。クレートには、実行可能ファイルにコンパイルされるバイナリクレートと、他のコードから依存されるライブラリクレートの2種類があります。
バイナリとライブラリ
バイナリクレートにはmain関数があり、実行可能なプログラムを生成します。ライブラリクレートにはmainがなく、他のクレートで使える再利用可能なアイテムを公開します。
- バイナリのルート：
src/main.rs - ライブラリのルート：
src/lib.rs
クレートルート
クレートルートは、コンパイラーが処理を開始するソースファイルです。モジュールツリーの頂点にあたり、パス中のcrateキーワードはこのファイルを指します。
fn main() {
crate::greet();
}
fn greet() {
println!("hello from the crate root");
}Cargoとパッケージ
パッケージは、Cargoが管理する1つ以上のクレートのまとまりで、Cargo.tomlに記述されます。1つのパッケージに含められるライブラリクレートは最大1つで、バイナリクレートは任意の数を含められます。
Cargoはビルド、テスト、依存関係を管理します。
最小限のCargo.toml
マニフェストには、パッケージ名、バージョン、依存関係を記述します。Cargoはこれを読み取り、プロジェクトのビルド方法を把握します。
[package]— 名前、バージョン、エディション[dependencies]— 外部クレート
標準的なプロジェクト構成
Cargoは慣例的な構成を想定しています。
src/main.rs— バイナリクレートのルートsrc/lib.rs— ライブラリクレートのルートsrc/bin/— 追加のバイナリtests/— 統合テスト
この慣例に従えば、設定は必要ありません。
モジュールはルートの下に存在する
クレートルートではモジュールを宣言でき、それらがモジュールツリーを形成します。作成するすべての要素は、この1つのルートファイルからつながります。
mod utils {
pub fn shout(s: &str) -> String {
s.to_uppercase()
}
}
fn main() {
println!("{}", utils::shout("crate"));
}ファイルへの分割
ルートでセミコロン付きのmod utils;を宣言すると、Cargoはsrc/utils.rsを読み込みます。そのファイルの内容がモジュールの本体となり、複数のファイルに分けても1つのツリーを維持できます。
バイナリからライブラリを使う
lib.rsとmain.rsの両方を持つパッケージでは、バイナリからパッケージ名でライブラリを参照します。ライブラリは、バイナリが利用するpubアイテムを公開します。
この分割により、ロジックをライブラリに置き、エントリーポイントを簡潔に保てます。
依存関係の追加
cargo add randを実行するか、Cargo.tomlの[dependencies]を編集します。Cargoはcrates.ioからクレートをダウンロードし、useで利用できるようにします。
また、再現可能なビルドのために、CargoはCargo.lockへ正確なバージョンを記録します。
全体像
小さい順に並べると、モジュール < クレート < パッケージです。モジュールはクレートを整理し、クレートルートがツリーの基点となり、パッケージとCargoが全体をまとめます。
理解度チェック
プロジェクト構成についての理解度を確認しましょう。
まとめ
プロジェクトの構成を学びました。
- クレートはバイナリまたはライブラリです
- クレートルート（
main.rsまたはlib.rs）がモジュールツリーの基点になります - パッケージはクレートをまとめたもので、
Cargo.tomlに記述されます - Cargoが構成、ビルド、依存関係を管理します
よくある質問
「クレートとクレートルート」レッスンは無料ですか？
はい。「クレートとクレートルート」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Learn Rust Codingコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Learn Rust Codingコースには全4レッスンが含まれています。
「クレートとクレートルート」で何を学びますか？
プロジェクト構成 ブラウザで直接実行するハンズオンコードでLearn Rust Codingを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
Learn Rust Codingを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのLearn Rust Codingは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン4/4です。
「クレートとクレートルート」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このLearn Rust Codingレッスンでコードを書いて実行できますか？
はい。すべてのLearn Rust Codingレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。