如何包含来自同一项目的另一个文件的模块？

Question

通过关注this guide，我创建了一个 Cargo 项目。

src/main.rs

fn main() {
    hello::print_hello();
}

mod hello {
    pub fn print_hello() {
        println!("Hello, world!");
    }
}

我使用的

cargo build && cargo run

它编译没有错误。现在我试图将主模块一分为二，但无法弄清楚如何从另一个文件中包含一个模块。

我的项目树是这样的

├── src
    ├── hello.rs
    └── main.rs

以及文件的内容：

src/main.rs

use hello;

fn main() {
    hello::print_hello();
}

src/hello.rs

mod hello {
    pub fn print_hello() {
        println!("Hello, world!");
    }
}

当我用cargo build 编译它时，我得到了

error[E0432]: unresolved import `hello`
 --> src/main.rs:1:5
  |
1 | use hello;
  |     ^^^^^ no `hello` external crate

我尝试按照编译器的建议修改main.rs为：

#![feature(globs)]

extern crate hello;

use hello::*;

fn main() {
    hello::print_hello();
}

但这仍然没有多大帮助，现在我明白了：

error[E0463]: can't find crate for `hello`
 --> src/main.rs:3:1
  |
3 | extern crate hello;
  | ^^^^^^^^^^^^^^^^^^^ can't find crate

有没有一个简单的例子说明如何将当前项目中的一个模块包含到项目的主文件中？

Answer 1

您的hello.rs 文件中不需要mod hello。任何文件中的代码，除了 crate 根目录（main.rs 用于可执行文件，lib.rs 用于库）在模块中自动命名空间。

要将来自hello.rs 的代码包含在您的main.rs 中，请使用mod hello;。它被扩展为hello.rs 中的代码（与您之前的完全一样）。您的文件结构保持不变，您的代码需要稍作更改：

main.rs：

mod hello;

fn main() {
    hello::print_hello();
}

hello.rs：

pub fn print_hello() {
    println!("Hello, world!");
}

Answer 2

如果您希望有嵌套模块...

生锈 2018

拥有文件mod.rs 是no longer required（尽管仍受支持）。惯用的替代方法是将文件命名为模块的名称：

$ tree src
src
├── main.rs
├── my
│   ├── inaccessible.rs
│   └── nested.rs
└── my.rs

main.rs

mod my;

fn main() {
    my::function();
}

my.rs

pub mod nested; // if you need to include other modules

pub fn function() {
    println!("called `my::function()`");
}

生锈 2015

您需要将mod.rs 文件放入与您的模块同名的文件夹中。 Rust by Example 解释得更好。

$ tree src
src
├── main.rs
└── my
    ├── inaccessible.rs
    ├── mod.rs
    └── nested.rs

main.rs

mod my;

fn main() {
    my::function();
}

mod.rs

pub mod nested; // if you need to include other modules

pub fn function() {
    println!("called `my::function()`");
}

Answer 3

我真的很喜欢园丁的回答。我一直在为我的模块声明使用建议。如果这有技术问题，请有人插话。

./src
├── main.rs
├── other_utils
│   └── other_thing.rs
└── utils
    └── thing.rs

main.rs

#[path = "utils/thing.rs"] mod thing;
#[path = "other_utils/other_thing.rs"] mod other_thing;

fn main() {
  thing::foo();
  other_thing::bar();
}

utils/thing.rs

pub fn foo() {
  println!("foo");
}

other_utils/other_thing.rs

#[path = "../utils/thing.rs"] mod thing;

pub fn bar() {
  println!("bar");
  thing::foo();
}

Answer 4

在非 main.rs（或 lib.rs）文件中，如果您想从同一目录中的文件中包含，则下面的代码有效。关键是使用单词super:: 作为包含。 （这就是我在不使用path的情况下重写@rodo的答案的方式）

目录树：

src
├── main.rs
├── my.rs
└── my
    ├── a.rs
    └── b.rs 

在 b.rs 中包含 a.rs：

src/my/a.rs:

pub fn function() {
    println!("src/my/a.rs/function()");
}

src/my/b.rs:

use super::b::function;

fn f2() {
    function();
}

src/my.rs:

mod a;
mod b;

src/main.rs:

mod my;