在Rust项目开发中是否可以避免使用mod.rs文件？

关于Rust mod.rs设计的相关疑问解答 #

首先先澄清一个常见误区：Rust并不强制要求每个子目录下都添加mod.rs文件，这是Rust 2015版本的遗留写法，从Rust 2018 edition开始，你完全可以用src/[模块名].rs的写法代替src/[模块名]/mod.rs，二者功能完全等价。比如你提到的结构里，完全可以删除models/mod.rs，在src下新建models.rs，在里面写pub mod login;，效果完全一致。

接下来对应你的疑问逐一解答：

为什么要设计这样的模块声明规则？

Rust的模块系统核心逻辑是显式声明，隐式引用：模块只需要在模块树的对应位置声明一次，全局都可以通过路径引用，不需要重复声明。
之所以要求显式声明模块，核心是为了避免隐式文件扫描带来的不可控问题：

• 不会因为目录下多了临时文件、测试文件就意外生成多余的模块
• 模块的可见性、导出规则可以统一收口，避免内部实现意外暴露给外部调用者

大量仅用于暴露子模块的mod.rs属于最佳实践吗？

如果你的mod.rs里只有pub mod xxx;这类子模块声明代码，完全可以换成前面提到的「同名.rs文件放在父目录」的写法，减少冗余的层级文件，看起来更清爽。
如果你的目录模块本身有独立的逻辑（比如models模块有通用的数据库实体Trait、通用查询方法等），就可以把这部分逻辑写在mod.rs（或者同名根文件）里，这时候这个文件是有实际逻辑的，不存在冗余问题。
目前Rust社区对两种写法都接受，没有强制的最佳实践，只要项目内的写法统一即可。

这种模块管理方式有什么优势？

• 可控性强：你可以精确控制每个模块的可见性，内部的工具模块、测试模块完全不会被外部意外访问
• API兼容性好：所有对外暴露的接口都可以在模块根文件里统一通过pub use重导出，外部调用者不需要关心你内部的文件结构拆分，你后续调整内部文件位置的时候，只要根文件的导出规则不变，外部调用代码完全不需要修改
• 编译效率更高：Rust编译器不需要遍历整个src目录扫描所有.rs文件，只需要根据你显式声明的模块树定位文件，增量编译的速度更快

关于你提到的「直接用crate::models::login;更清晰」的问题

这种路径引用写法本身是完全支持的，你只需要在models模块的根文件里声明过pub mod login;，项目任意位置都可以通过这个路径引用，不需要重复声明。
Rust不支持「不声明mod直接用路径引用」的核心原因是这种隐式模块逻辑会带来很多不可控风险，比如你在models目录下临时存了一个draft.rs的草稿文件，隐式扫描的话就会自动生成crate::models::draft模块，很容易出现意外暴露、命名冲突的问题。

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