先生と生徒の会話形式で理解しよう

生徒

「Rustでプログラムを書き始めたのですが、コードが長くなってくると一つのファイルでは管理が大変になってきました。どうすれば整理できますか？」

先生

「それは成長の証ですね！Rustにはモジュール（Modules）という仕組みがあります。これを使えば、関数や構造体をグループ化して、コードを綺麗に整理・分割することができますよ。」

生徒

「ファイルを分けるだけではないんですか？何だか難しそうなイメージがあります。」

先生

「単なるファイル分割だけではなく、どの機能を外部に公開するかというカプセル化も同時に行えるのが特徴です。保守性の高い設計には欠かせない知識なので、一緒に見ていきましょう！」

1. Rustにおけるモジュールの役割とは

Rustの学習を進めていくと、複雑なロジックを実装する機会が増えてきます。そんな時に、すべてのプログラムを一つのファイル（例えば main.rs）に詰め込んでしまうと、どこに何が書いてあるのか把握するのが難しくなり、修正時の影響範囲も分かりにくくなります。

ここで登場するのがモジュール（Modules）です。モジュールには大きく分けて以下の三つの重要な役割があります。

コードのグループ化： 関連する機能（関数、構造体、トレイトなど）を一つの名前空間にまとめます。
カプセル化（可視性の制御）： 外部からアクセスできる項目と、内部だけで使用する項目を区別します。
名前空間の提供： 同じ名前の関数であっても、モジュールが異なれば名前の衝突を避けることができます。

Rustのモジュールシステムは、大規模な開発プロジェクトにおいて、コードの再利用性を高め、メンテナンスの負荷を軽減するために不可欠なシステムです。モジュールを正しく理解することは、中級者への大きなステップとなります。

2. インラインモジュールの書き方と基本構造

まずは、最もシンプルな「インラインモジュール」の書き方を学びましょう。これは、一つのファイルの中に mod キーワードを使ってモジュールを定義する方法です。小さなプログラムや、テストコードを記述する際によく使われます。

以下の例では、garden というモジュールの中に、植物を育てる関数を定義しています。


mod garden {
    // デフォルトでは非公開なので、pubキーワードをつけて公開する
    pub fn plant_flower() {
        println!("庭に花を植えました！");
    }

    fn water_plants() {
        println!("植物に水をあげました。");
    }
}

fn main() {
    // スコープ指定演算子「::」を使って呼び出す
    garden::plant_flower();

    // 以下の行はコンパイルエラーになります（water_plantsは非公開のため）
    // garden::water_plants();
}

Rustの重要なルールとして、「モジュール内の要素はデフォルトで非公開（プライベート）」という点があります。外部（この場合は main 関数）から呼び出すためには、pub キーワードを付与して「パブリック」にする必要があります。これにより、意図しない場所から内部ロジックを触られることを防ぎ、安全性を高めています。

3. 関数定義の基本と引数の渡し方

モジュールについて深く知る前に、Rustの関数定義についても復習しておきましょう。Rustでは fn キーワードを使用して関数を宣言します。引数と戻り値には必ず型を明示する必要があります。これは静的型付け言語であるRustが、コンパイル時に厳密なチェックを行うためです。

関数は、単に命令を並べるだけでなく、値を加工して返す役割を持ちます。Rustでは関数の最後にセミコロンを付けない「式」を書くことで、それを戻り値として扱う特徴的な構文があります。


// 二つの数値を足して結果を返す関数
fn add_numbers(a: i32, b: i32) -> i32 {
    a + b // セミコロンがないので、この値が返される
}

fn main() {
    let result = add_numbers(10, 20);
    println!("計算結果は {} です", result);
}


計算結果は 30 です

このように、関数を適切に定義し、それをモジュールで包むことで、プログラムの部品化が進みます。引数の型や戻り値の型を正しく指定することで、型安全なコードを記述できるようになります。

4. ファイル分割によるモジュールの管理

プログラムが大きくなると、一つのファイルに複数の mod を書くのは限界が来ます。そこで、モジュールを別のファイルに切り出す方法が推奨されます。Rustでは、ファイル名そのものがモジュール名として機能します。

例えば、src/main.rs と同じディレクトリに auth.rs というファイルを作成したとしましょう。

src/auth.rs の内容:


pub fn login(username: &str) {
    println!("{} さんがログインしました。", username);
}

src/main.rs の内容:


mod auth; // auth.rsの内容をモジュールとして読み込む

fn main() {
    auth::login("タロウ");
}

このように、mod auth; と宣言するだけで、Rustコンパイラは同名のファイルを探して読み込んでくれます。ディレクトリ構造を工夫することで、巨大なアプリケーションでも階層的に管理することが可能になります。ファイル分割を行うことで、チーム開発でのコードの衝突を防ぎ、読みやすさを劇的に向上させることができます。

5. pubキーワードとモジュールの可視性

Rustの「可視性（Visibility）」の概念は、初心者が最初につまずきやすいポイントの一つです。モジュールを分けただけでは、その中身を使うことはできません。Rustは「隠せるものはすべて隠す」という設計思想に基づいているからです。

可視性にはいくつかのレベルがあります。

pub： どこからでもアクセス可能。
pub(crate)： 現在のクレート（プロジェクト全体）内であればアクセス可能。
pub(super)： 親モジュールからアクセス可能。
（指定なし）： 現在のモジュールとその子モジュールからのみアクセス可能。

この仕組みにより、ライブラリの開発者は「ユーザーに使ってほしい機能」だけを pub で公開し、内部の複雑な処理や変更される可能性のある実装詳細は非公開に保つことができます。これを「情報の隠蔽」と呼び、バグの少ない堅牢なソフトウェアを作るための重要なテクニックです。

6. useキーワードでパスを簡略化する

深い階層にあるモジュール内の関数を呼び出す際、毎回 crate::network::server::connect(); のように長いフルパスを書くのは大変です。そこで便利なのが use キーワードです。これを使うと、特定の項目を現在のスコープにインポートし、短い名前で呼び出せるようになります。


mod communication {
    pub mod client {
        pub fn request() {
            println!("サーバーにリクエストを送信中...");
        }
    }
}

// useを使ってパスを短縮
use communication::client;

fn main() {
    // client:: で呼び出せるようになる
    client::request();
}

また、use communication::client::request; と書けば、直接 request(); と呼び出すことも可能です。ただし、あまりに多くの関数を直接インポートすると、どこで定義された関数なのか分かりにくくなるため、親モジュールまでをインポートするのがRustの慣習（イディオム）とされています。

7. 構造体と列挙型のモジュール管理

関数だけでなく、構造体（struct）や列挙型（enum）もモジュールで管理されます。構造体の場合、構造体自体に pub をつけるだけでなく、その中の個別の「フィールド」にも pub をつける必要がある点に注意してください。これもRustの徹底した安全管理の表れです。


mod office {
    pub struct Employee {
        pub name: String,   // 公開フィールド
        salary: u32,        // 非公開フィールド（給料は秘密！）
    }

    impl Employee {
        pub fn new(name: &str, salary: u32) -> Employee {
            Employee {
                name: String::from(name),
                salary,
            }
        }
    }
}

fn main() {
    let emp = office::Employee::new("田中", 300000);
    println!("名前: {}", emp.name);
    
    // 以下の行はエラーになります（salaryは非公開）
    // println!("給料: {}", emp.salary);
}

このように、データの一部だけを隠すことで、外部からの不適切なデータ操作を防ぎ、オブジェクトの状態を正しく保つことができます。Rustのモジュールシステムは、単なる整理整頓の道具ではなく、プログラムの「正しさ」を保証するための防壁なのです。

8. クレートと外部ライブラリの利用

Rustの世界では、プロジェクトの単位を「クレート（Crate）」と呼びます。自分で作成したモジュールの集まりも一つのクレートですし、crates.io などで公開されている外部ライブラリもクレートです。モジュールシステムを理解すると、これらの外部クレートの使い方も自然と理解できるようになります。

外部ライブラリを使用する場合、Cargo.toml に依存関係を記述し、コード内で use を使って呼び出します。これは、自作のモジュールを use で呼び出すのと全く同じ感覚で行えます。Rustの一貫した設計思想により、自分のコードも他人のコードも同じように美しく構造化できるのです。

モジュールと関数、そして可視性のルールをマスターすれば、Rustでの開発はより自由で、かつ安全なものになります。最初は pub の付け忘れでコンパイルエラーに遭遇することも多いでしょう。しかし、そのエラーメッセージこそが、あなたのプログラムをより堅牢にするためのRustからのアドバイスなのです。一歩ずつ、構造化された美しいコードを目指していきましょう！