Ответ 1

В основном модуле (main.rs, lib.rs или subdir/mod.rs) вам нужно написать mod a; для всех остальных модулей, которые вы хотите использовать во всем проекте (или в поддиректории).

В любом другом модуле вам нужно написать use a; или use a::foo;

Вы далеко не единственный, кого это смущает, и, безусловно, можно добиться большего, но любые изменения в модульной системе будут отклонены как "слишком запутанные".

Изменение: этот ответ был написан для языкового стандарта "Rust 2015". Изменения были внесены в стандарт "Rust 2018", см. Этот пост в блоге.

Ответ 2

В Rust есть несколько ключевых слов для работы с модулями:

extern crate

extern crate заполняет пробел между Cargo и Rust. Мы пишем код в файле .rs, этот файл может быть скомпилирован с помощью rustc. Cargo будет управлять внешними зависимостями и вызывать rustc. Строка extern crate... указывает компилятору искать это пространство имен, поэтому оно однозначно.

Примечание редактора - extern crate не требуется во многих случаях, если вы используете версию Rust 2018.

mod

mod имеет два применения:

• при использовании с фигурными скобками он объявляет модуль (пространство имен).
• при использовании только с именем, он будет искать модуль в локальной файловой системе.

Модули могут быть:

• файлы с расширением .rs
• папки с одним файлом с именем mod.rs

use

use импортирует пространство имен. Мы должны объявить, что мы собираемся использовать, прежде чем использовать его. Предложение use довольно строгое, если мы use module1::moduleA; Никакой другой модуль из модуля module1 не будет доступен, кроме moduleA Звездочка (*) может использоваться для использования всего в модуле: use module1::*; , Также можно использовать наборы: use module1::{moduleA, moduleB};

Пример:

| main.rs
|- module1
      |- mod.rs
      |- moduleA.rs
      |- moduleB.rs

mod.rs содержит:

pub mod moduleA; // declare a child module
pub mod moduleB; // declare a child module

main.rs содержит:

///  ======
// use what Cargo downloaded
extern crate that_one_thing_i_need;

///  ======

mod module1; // declare a child module

// some local stuff I want to scope
mod local {
    pub fn my_function() {}
}

//   ======

// make the symbols locally available:
use module1::moduleA::*;
use module1::moduleB::{functionX, moduleY, typeZ};

// we still need to announce what stuff from the external crate
// we want to use:
// We can do local aliases that will be valid in this one file.
use that_one_thing_i_need::fancy_stuff as fs;

///  ======

fn main() {
    // we can use anything here from the namespaces we are using:
    //      moduleA
    //      functionX
    //      moduleY
    //      typeZ
    //      fs

    // We can access stuff by navigating from the outermost visible
    // module name
    local::my_function();
}

Символы можно использовать только из модуля. Если вы хотите преодолеть этот барьер (даже в локально объявленном модуле), нам нужно сделать их общедоступными с помощью ключевого слова pub.