Rust库路径链接问题：header.rs无法引用aes_agent模块

问题场景 #

现有Rust项目目录结构（修正原输入的路径箭头错误）：

.
├── Cargo.toml
├── readme.txt
├── src
│   ├── config.rs
│   ├── libraries
│   │   └── cryptography
│   │       └── primitives
│   │           └── cipher
│   │               └── symmetric
│   │                   └── aes
│   │                       └── aes_agent.rs
│   ├── main.rs
│   └── header.rs

在main.rs中通过嵌套mod声明，可正常引用并调用aes_agent模块的print_me方法：

use libraries::cryptography::primitives::cipher::symmetric::aes::aes_agent as aes_cipher;

mod libraries {
    pub mod cryptography {
      pub mod primitives {
        pub mod cipher {
          pub mod symmetric {
            pub mod aes {
                pub mod aes_agent;
            }
          }
        }
      }
    }
}

mod header;

fn main() {
    let _ = &aes_cipher::print_me();
    println!("Hello, world in main!");
}

但在header.rs中重复相同的模块声明时，会出现编译错误：

Compiling lab_00 v0.1.0 (/home/runner/HelloRust)
error[E0583]: file not found for module aes_agent
 --> src/header.rs:9:17
  |
9 |                 pub mod aes_agent;
  |                 ^^^^^^^^^^^^^^^^^^

原因是header.rs作为main.rs引入的子模块，其相对路径查找范围是自身所在的虚拟目录，无法定位到src/libraries下的文件；而main.rs是crate根，和libraries目录同级，相对路径查找有效。

更优的模块组织与引用方案 #

1. 标准化顶级模块声明（推荐） #

通过在crate根统一声明模块树，所有子文件通过绝对路径引用，彻底避免重复声明：

步骤1：补充mod.rs文件

给每个子目录添加mod.rs，用来导出下一级模块：

src/libraries/
├── mod.rs
└── cryptography/
    ├── mod.rs
    └── primitives/
        ├── mod.rs
        └── cipher/
            ├── mod.rs
            └── symmetric/
                ├── mod.rs
                └── aes/
                    ├── mod.rs
                    └── aes_agent.rs

每个mod.rs只需导出对应子模块：

• src/libraries/mod.rs：

  pub mod cryptography;
  

• src/libraries/cryptography/mod.rs：

  pub mod primitives;
  

• 以此类推，直到src/libraries/cryptography/primitives/cipher/symmetric/aes/mod.rs：

  pub mod aes_agent;
  

步骤2：简化文件引用

• main.rs中只需声明一次顶级模块，直接引用：

  mod libraries;
  use libraries::cryptography::primitives::cipher::symmetric::aes::aes_agent as aes_cipher;
  
  mod header;
  
  fn main() {
      let _ = &aes_cipher::print_me();
      println!("Hello, world in main!");
  }
  

• header.rs中通过crate根路径直接引用，无需重复声明模块树：

  use crate::libraries::cryptography::primitives::cipher::symmetric::aes::aes_agent;
  
  pub fn demo_func() {
      aes_agent::print_me();
  }
  

2. Rust 2018+简化写法（无需mod.rs） #

如果不想创建大量mod.rs，可以用Rust 2018引入的目录-文件对应规则：

• 将src/libraries/cryptography/目录改为src/libraries/cryptography.rs，在文件中声明pub mod primitives;
• 同时创建src/libraries/cryptography/目录，存放primitives.rs文件，文件内声明pub mod cipher;
• 以此类推，每个层级用同名文件代替mod.rs，目录存放子模块文件。这种方式更简洁，结构更直观。

3. 核心注意事项 #

不要在多个文件中重复声明同一模块树，这会导致每个文件在自身作用域内独立查找相对路径，必然出现文件找不到的错误。统一在crate根声明顶级模块，其他文件通过crate::前缀引用绝对路径，是Rust模块组织的标准做法。

内容的提问来源于stack exchange，提问作者Moirisa Dikaiosýni