如何在 Rust 中使用父模块导入？

如果你有这样的目录结构：

src/main.rs
src/module1/blah.rs
src/module1/blah2.rs
src/utils/logging.rs

如何使用其他文件中的函数？

从 Rust 教程来看，听起来我应该能够做到这一点：

main.rs

mod utils { pub mod logging; }
mod module1 { pub mod blah; }

fn main() {
    utils::logging::trace("Logging works");
    module1::blah::doit();
}

日志记录.rs

pub fn trace(msg: &str) {
    println!(": {}\n", msg);
}

blah.rs

mod blah2;
pub fn doit() {
    blah2::doit();
}

blah2.rs

mod utils { pub mod logging; }
pub fn doit() {
    utils::logging::trace("Blah2 invoked");
}

但是，这会产生错误：

error[E0583]: file not found for module `logging`
 --> src/main.rs:1:21
  |
1 | mod utils { pub mod logging; }
  |                     ^^^^^^^
  |
  = help: name the file either logging.rs or logging/mod.rs inside the directory "src/utils"

看来沿着路径导入，即从main to module1/blah.rs作品，并导入同行，即blah2 from blah有效，但从父范围导入则无效。

如果我使用魔法#[path]指令，我可以做到这一点：

blah2.rs

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

pub fn doit() {
    logging::trace("Blah2 invoked");
}

我真的必须手动使用相对文件路径从父范围级别导入某些内容吗？ Rust 中没有更好的方法吗？

在Python中，你使用from .blah import x对于本地范围，但如果你想访问绝对路径，你可以使用from project.namespace.blah import x.

我也将为其他发现这个问题并且（像我一样）被难以理解的答案完全困惑的人回答这个问题。

归结为我认为教程中解释得不好的两件事：

• The mod blah;语法为编译器导入一个文件。你必须在要编译的所有文件上使用它.

• 除了共享库之外，任何定义的本地模块都可以使用以下命令导入到当前作用域中：use blah::blah;.

一个典型的例子是：

src/main.rs
src/one/one.rs
src/two/two.rs

在这种情况下，您可以将代码放在one.rs from two.rs通过使用use:

use two::two;  // <-- Imports two::two into the local scope as 'two::'

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

然而，main.rs必须是这样的：

use one::one::bar;        // <-- Use one::one::bar 
mod one { pub mod one; }  // <-- Awkwardly import one.rs as a file to compile.

// Notice how we have to awkwardly import two/two.rs even though we don't
// actually use it in this file; if we don't, then the compiler will never
// load it, and one/one.rs will be unable to resolve two::two.
mod two { pub mod two; }  

fn main() {
    bar();
}

请注意，您可以使用blah/mod.rs文件以在一定程度上缓解尴尬，通过放置类似的文件one/mod.rs， 因为mod x;尝试x.rs and x/mod.rs作为负载。

// one/mod.rs
pub mod one.rs

您可以将 main.rs 顶部的尴尬文件导入减少为：

use one::one::bar;       
mod one; // <-- Loads one/mod.rs, which loads one/one.rs.
mod two; // <-- This is still awkward since we don't two, but unavoidable.    

fn main() {
    bar();
}

有一个示例项目在执行此操作Github https://github.com/shadowmint/rust-starter.

值得注意的是，模块独立于代码块所在的文件；尽管这似乎是加载文件的唯一方法blah.rs是创建一个名为blah，您可以使用#[path]如果出于某种原因需要的话，可以解决这个问题。不幸的是，它似乎不支持通配符，将多个文件中的函数聚合到顶级模块中相当乏味。