pub use，它允许您从其他模块重新导出标识符。在Rust的std::io crate中有先例，其中一些类型从子模块re-exported for use in std::io。src/
lib.rs
vector.rs
main.rs
这是您的 main.rs 文件：
extern crate math;
use math::vector;
fn main() {
println!("{:?}", vector::VectorA::new());
println!("{:?}", vector::VectorB::new());
}
而你的 src/lib.rs：
#[crate_id = "math"];
#[crate_type = "lib"];
pub mod vector; // exports the module defined in vector.rs
src/vector.rs：// exports identifiers from private sub-modules in the current
// module namespace
pub use self::vector_a::VectorA;
pub use self::vector_b::VectorB;
mod vector_b; // private sub-module defined in vector_b.rs
mod vector_a { // private sub-module defined in place
#[derive(Debug)]
pub struct VectorA {
xs: Vec<i64>,
}
impl VectorA {
pub fn new() -> VectorA {
VectorA { xs: vec![] }
}
}
}
math::vector::vector_a，其中有一些特殊向量的实现。但我们不希望你的库的客户端关心是否有vector_a子模块。相反，我们想在math::vector模块中提供它。这可以通过pub use self::vector_a::VectorA来完成，它重新导出当前模块中的vector_a::VectorA标识符。mod vector_b;行的作用。它指示Rust编译器查找vector_b.rs文件以实现该模块。确实，这就是我们的src/vector_b.rs文件。#[derive(Debug)]
pub struct VectorB {
xs: Vec<i64>,
}
impl VectorB {
pub fn new() -> VectorB {
VectorB { xs: vec![] }
}
}
从客户端的角度来看，VectorA和VectorB在两个不同的模块和文件中定义这一事实是完全不透明的。
如果你在与main.rs相同的目录中，你应该能够通过以下方式运行它：
rustc src/lib.rs
rustc -L . main.rs
./main
src/
lib.rs
vector/
mod.rs
vector_b.rs
main.rs
math::Vec2而不是math::vector::Vec2。（即相同的概念但深入一个模块。） - BurntSushi5Rust模块规则如下：
因此，在math目录中的文件matrix.rs1就是 模块math::matrix。很简单。您在文件系统中看到的也可以在源代码中找到。这是由文件路径和模块路径之间的一对一对应关系实现的。2
因此，您可以使用use math::matrix::Matrix导入结构体Matrix，因为该结构体位于math目录中的文件matrix.rs中。不满意？您更喜欢使用use math::Matrix;吗？这也是可能的。通过以下方式在math/mod.rs中重新导出标识符math::matrix::Matrix：
pub use self::math::Matrix;
还有一步需要完成才能使其工作。Rust需要一个模块声明来加载这个模块。在main.rs中添加mod math;。如果您不这样做，当像这样导入时，编译器会提示错误信息：
error: unresolved import `math::Matrix`. Maybe a missing `extern crate math`?
mod math;
pub use math::Matrix;
模块声明对子模块vector、matrix和complex也是必要的，因为math需要加载它们并重新导出它们。只有在加载标识符所在的模块后，标识符的重新导出才有效。这意味着，要重新导出标识符math::matrix::Matrix，您需要编写mod matrix;。您可以在math/mod.rs中执行此操作。因此请创建具有以下内容的文件：
mod vector;
pub use self::vector::Vector;
mod matrix;
pub use self::matrix::Matrix;
mod complex;
pub use self::complex::Complex;
完成啦。
1Rust中源文件名通常以小写字母开头。这就是为什么我使用matrix.rs而不是Matrix.rs的原因。
2Java则不同。你还需要用package声明路径。这太冗余了。文件系统中源文件的位置已经很明显了，为什么还要在文件顶部重复声明呢？当然有时候查看源代码比查找文件系统中的位置更容易。我理解那些认为这样做会更少让人困惑的人们。
大部分 Rust 纯粹主义者可能会称我为异端并且憎恨这个解决方案，但这样做更加简单：只需将每个事物放在它自己的文件中，然后在 mod.rs 中使用 "include!" 宏：
include!("math/Matrix.rs");
include!("math/Vector.rs");
include!("math/Complex.rs");
这样做可以避免添加嵌套模块，并且避免复杂的导出和重写规则。 简单、有效，没有麻烦。
meth/Matrix.rs和math/Vector.rs都不能有use rand;。此外，您不能在各自的文件中有tests子模块。 - Momchil Atanasov好的，我和编译器搏斗了一段时间，最终让它工作了（感谢BurntSushi指出了pub use）。
main.rs：
use math::Vec2;
mod math;
fn main() {
let a = Vec2{x: 10.0, y: 10.0};
let b = Vec2{x: 20.0, y: 20.0};
}
数学/mod.rs:
pub use self::vector::Vec2;
mod vector;
数学/向量.rs
use std::num::sqrt;
pub struct Vec2 {
x: f64,
y: f64
}
impl Vec2 {
pub fn len(&self) -> f64 {
sqrt(self.x * self.x + self.y * self.y)
}
// other methods...
}
同样的方式可以添加其他结构体。注意：使用0.9编译，而不是master。
main.rs 中使用 mod math; 会使您的 main 程序与您的库耦合在一起。如果您希望您的 math 模块独立，您需要单独编译它，并使用 extern crate math 进行链接（如我的答案所示）。在 Rust 0.9 中，语法可能是 extern mod math。 - BurntSushi5我想在这里补充一下如何在Rust中包含深度嵌套的文件。 我有以下结构：
|-----main.rs
|-----home/
|---------bathroom/
|-----------------sink.rs
|-----------------toilet.rs
如何从main.rs访问sink.rs或toilet.rs？
正如其他人提到的，Rust不知道文件。相反，它将所有内容视为模块和子模块。要访问浴室目录中的文件，您需要导出它们或在顶部加上barrel。您可以通过在文件中指定文件名以及不带rs扩展名的目录中的文件名 pub mod filename_inside_the_dir_without_rs_ext来实现这一点。
例如。
// sink.rs
pub fn run() {
println!("Wash my hands for 20 secs!");
}
// toilet.rs
pub fn run() {
println!("Ahhh... This is sooo relaxing.")
}
在home目录下创建一个名为bathroom.rs的文件：
导出文件名：
// bathroom.rs
pub mod sink;
pub mod toilet;
创建一个名为home.rs的文件，放在main.rs旁边
pub mod bathroom.rs文件
// home.rs
pub mod bathroom;
在 main.rs 文件中
// main.rs
// Note: If you mod something, you just specify the
// topmost module, in this case, home.
mod home;
fn main() {
home::bathroom::sink::run();
}
use 语句也可以使用：
// main.rs
// Note: If you mod something, you just specify the
// topmost module, in this case, home.
use home::bathroom::{sink, toilet};
fn main() {
sink::run();
sink::toilet();
}
如果你想在toilet.rs中使用sink.rs，可以通过指定self或super关键字来调用模块。
// inside toilet.rs
use self::sink;
pub fn run() {
sink::run();
println!("Ahhh... This is sooo relaxing.")
}
你将得到类似于这样的东西：
|-----main.rs
|-----home.rs
|-----home/
|---------bathroom.rs
|---------bathroom/
|-----------------sink.rs
|-----------------toilet.rs
上面的结构只适用于Rust 2018及以后版本。下面的目录结构也适用于2018，但这是2015年的工作方式。
|-----main.rs
|-----home/
|---------mod.rs
|---------bathroom/
|-----------------mod.rs
|-----------------sink.rs
|-----------------toilet.rs
home/mod.rs与./home.rs相同，home/bathroom/mod.rs与home/bathroom.rs相同。Rust进行了此更改，因为编译器会因为包含与目录同名的文件而感到困惑。2018年版（首先显示的版本）修复了这个结构。
有关更多信息，请参见此存储库，并查看此YouTube视频以获取整体说明。
还有一件事...避免使用连字符！请改用snake_case。
您必须将所有文件都列在最上面，即使顶层文件不需要深度文件。
这意味着，为了让sink.rs发现toilet.rs，您需要通过上述方法将它们全部列出，直到main.rs！
换句话说，在toilet.rs内执行pub mod sink;或use self::sink;将不起作用，除非您已将它们全部公开到main.rs！
因此，请记得将您的文件罗列到顶部！
src 文件夹内。 - Jose A我从Github上学到了一种更加高效的导出模块方法。
mod foo {
//! inner docstring comment 1
//! inner docstring comment 2
mod a;
mod b;
pub use a::*;
pub use b::*;
}
将问题示例目录和文件名调整为符合Rust命名约定：
main.rs
math.rs
math/
vector.rs
matrix.rs
complex.rs
请确保在math目录中的每个文件中导出公共符号（类型、函数等），方法是在它们之前加上关键字pub。
定义math.rs：
mod vector;
pub use vector::*;
mod matrix;
pub use matrix::*;
mod complex;
pub use complex::*;
上述文件将math的子模块保持为私有，但子模块的公共符号从模块math中导出。这有效地扁平化了模块结构。
在main.rs中使用math::Vector：
mod math;
use crate::math::Vector;
fn main() {
// ...
}
foo::bar::Baz结构体应该定义在foo/bar.rs或foo/bar/mod.rs中。 - Chris Morgancrate_name::module::foo::Foo，反复出现，而且还带着过于冗长、无用、重复的描述…… 在Rust领域中，由于难以理解的原因，希望使用目录来组织文件，并将类/结构体/特性/接口等逻辑分割到不同文件中被认为是“异常”的事实，实在令人不安，我个人觉得。 - Joey Sabey