Rust调用rand模块无需引入子模块，为何自定义嵌套模块调用报错？

为什么rand::thread_rng()不需要加Rng::前缀 #

• rand::Rng是trait（特征），不是存放thread_rng()的模块。thread_rng()是定义在rand crate根模块的公共自由函数，完整路径就是rand::thread_rng()，返回值是实现了Rng trait的ThreadRng结构体实例。
• 你写use rand::Rng;的作用不是导入模块路径，是把Rng trait引入当前作用域——Rust的规则是，只有trait在当前作用域可见时，你才能调用这个trait为类型实现的方法，也就是后面的.gen_range(0,100)。如果不写这行use，哪怕你拿到了ThreadRng实例，编译器也会提示找不到gen_range方法。
• 整行代码的调用逻辑是：先调用根模块下的thread_rng()拿到随机数生成器实例，再调用这个实例上Rng trait实现的gen_range方法，和把thread_rng归到Rng名下调用完全是两回事。

自定义模块代码报错的原因 #

你写的测试代码里，hello函数的完整路径是first::second::hello，根本没有定义在first模块下，直接写first::hello()当然会报找不到函数的错误。
原错误代码：

mod first{
   pub mod second{
      pub fn hello(){println!("hello");}
   }
}

use first::second;
fn main(){
   first::hello(); // 路径错误，first模块下没有直接定义hello
}

Rust的模块路径严格对应代码的嵌套层级，use语句的作用只是把指定条目引入当前作用域，让你可以用更短的名字调用，不会改变条目本身的所属层级。这段代码有三种合法调用方式：

1. 写全完整路径调用，不需要额外use：

   mod first{
      pub mod second{
         pub fn hello(){println!("hello");}
      }
   }
   
   fn main(){
      first::second::hello();
   }
   

2. 导入second模块后，通过模块名调用：

   mod first{
      pub mod second{
         pub fn hello(){println!("hello");}
      }
   }
   
   use first::second;
   fn main(){
      second::hello();
   }
   

3. 直接把hello函数导入当前作用域，无前缀调用：

   mod first{
      pub mod second{
         pub fn hello(){println!("hello");}
      }
   }
   
   use first::second::hello;
   fn main(){
      hello();
   }
   

核心规则总结 #

• 模块路径严格匹配嵌套层级，公共条目必须按定义的层级从外到内写路径，跨层级调用不能跳过中间模块。
• 要调用某个trait定义的方法，必须保证该trait在当前作用域可见（即写对应use语句导入trait），否则即使类型实现了该trait，也调用不了对应方法。
• 不要混淆trait和模块的概念：trait是用来给类型加行为的约束，不是用来组织代码的命名空间，trait本身不会存放自由函数。

内容的提问来源于stack exchange，提问作者spicy-lemonade