Rust同一项目中不同crate能否使用同名模块？及相关机制疑问

问题背景 #

尝试为项目中不同的二进制crate创建同名模块foo时，发现两个mod foo;声明都指向了同一个src/bin/foo.rs文件，目录结构如下：

/src/bin/main_one.rs // 声明 `mod foo;`
/src/bin/main_two.rs // 声明 `mod foo;`
/src/bin/foo.rs // 唯一存在的foo.rs文件

由此产生以下疑问：

1. 模块定义是否除了crate内的声明位置外，还与文件层级耦合？
2. 是否唯一的解决方案是使用不同名称的模块？
3. 如果模块通过文件系统位置关联代码，mod关键字的意义是否仅用于隐私控制？

问题解答 #

1. 模块与文件层级的耦合关系 #

是的，Rust的模块系统与文件系统强耦合。对于src/bin下的每个.rs文件，它们都是独立的二进制crate，当你在crate根文件中声明mod foo;时，Rust会按照固定规则查找模块文件：优先在当前crate的根目录下寻找foo.rs，或者foo/mod.rs。因此，两个同目录下的二进制crate的mod foo;声明，都会指向同一个src/bin/foo.rs文件。

2. 同名模块冲突的解决方案（不止改名称） #

不是只能用不同名称的模块，还有两种更合理的方案：

• 为每个二进制crate创建独立子目录
  把每个二进制crate的代码放到单独的子目录中，让模块文件和对应crate同目录，避免共享文件：

  src/bin/main_one/main.rs // 声明 `mod foo;`，加载同目录的foo.rs
  src/bin/main_one/foo.rs
  src/bin/main_two/main.rs // 声明 `mod foo;`，加载同目录的foo.rs
  src/bin/main_two/foo.rs
  

• 使用#[path]属性指定模块路径
  在声明模块时通过#[path]显式指定对应的文件，这样不用修改模块名：

  // main_one.rs
  mod foo; // 默认加载src/bin/foo.rs
  
  // main_two.rs
  #[path = "foo-for-two.rs"]
  mod foo; // 加载指定的foo-for-two.rs
  

3. mod关键字的核心作用 #

mod关键字的意义远不止隐私控制，主要包括：

• 代码组织与边界划分：将代码拆分为逻辑独立的模块，提升代码的可维护性和可读性。
• 访问权限控制：通过pub、pub(crate)、pub(in path)等修饰符，控制模块内项的可见范围（即你提到的隐私控制）。
• 关联文件系统：告诉Rust编译器去哪里加载模块对应的代码文件，这是模块系统与文件耦合的核心逻辑。
• 支持嵌套模块：允许在模块内部声明子模块，构建层级化的代码结构，比如mod bar { mod baz; }。

内容的提问来源于stack exchange，提问作者aryzing