如何在Rust中正确导入文件？兼顾rustc编译与Cargo构建

我需要正确配置Rust的导入，要满足两个核心目标：

• 每个单独的脚本都能通过rustc直接编译
• 同时兼容Cargo构建流程

目前用绝对路径的方式能实现，但相对路径无法生效，而且我认为绝对路径不是合理的解决方案。请问正确的导入处理方式是什么？

示例1 #

文件结构 #

src
├── main.rs
├── root
│   └── nested.rs
└── root.rs

绝对路径实现（可行但不推荐） #

// main.rs:
#[path="root/nested.rs"] 
mod nested 
#[path="root.rs"] 
mod root

// root.rs:
#[path="root/nested.rs"] 
mod nested

相对路径尝试（无法用rustc编译） #

// main.rs:
mod root; 
use crate::root::nested;

// root.rs --> 无法使用`rustc`编译
pub mod nested;

示例2 #

文件结构 #

src
├── main.rs
├── notnested.rs
└── root.rs

绝对路径实现（可行但不推荐） #

// main.rs:
#[path="notnested.rs"] 
mod notnested 
#[path="root.rs"] 
mod root

// root.rs:
#[path="notnested.rs"] 
mod notnested

相对路径尝试（无法用rustc编译） #

// main.rs:
mod root 
mod notnested

// root.rs --> 无法使用`rustc`编译
use crate::notnested;

正确配置方案 #

要同时满足两种构建方式，核心是遵循Rust的模块命名约定，同时给rustc提供正确的上下文，避免依赖#[path]硬编码路径。

针对示例1的调整 #

1. 保持Cargo兼容的模块声明：
   按照Cargo的约定编写代码，无需手动指定路径：

   // main.rs
   mod root;
   use crate::root::nested;
   
   // root.rs
   pub mod nested; // 自动对应src/root/nested.rs，Cargo可直接识别
   

2. 单独编译root.rs的指令：
   用rustc编译子模块时，需要指定模块根目录，让编译器找到依赖的nested.rs：

   rustc src/root.rs --module-path-root src
   

   或者直接将依赖的模块文件作为参数传入：

   rustc src/root.rs src/root/nested.rs --crate-type lib
   

3. 编译main.rs的指令：
   直接执行即可，rustc会自动解析所有关联模块：

   rustc src/main.rs
   

针对示例2的调整 #

1. 保持Cargo兼容的导入写法：

   // main.rs
   mod root;
   mod notnested;
   
   // root.rs
   use crate::notnested; // Cargo下可直接识别根模块下的notnested
   

2. 单独编译root.rs的指令：
   需要将依赖的notnested.rs一同传入编译器：

   rustc src/root.rs src/notnested.rs --crate-type lib
   

   或者指定根目录：

   rustc src/root.rs --module-path-root src
   

3. 编译main.rs的指令：
   直接执行即可：

   rustc src/main.rs
   

通用规则总结 #

• 优先遵循Cargo模块约定：这是兼容两种构建方式的基础，约定规则为：
  • src/foo.rs 对应根模块中的 mod foo;
  • src/foo/bar.rs 对应src/foo.rs中的 pub mod bar;
• rustc单独编译子模块的要点：
  • 编译时需通过--module-path-root src指定根目录，或直接传递所有依赖的模块文件
  • 若编译库模块，需加上--crate-type lib参数
• 避免使用#[path]：硬编码路径会破坏模块结构的可维护性，仅在特殊场景下使用

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