You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

能否在Rust中同时声明模块并在子目录放置对应文件?

Rust模块路径与文件结构问题解答

可以将b.rs放在a/子目录下,但需要调整a.rs里的模块声明方式,同时理解Rust模块系统的默认映射规则。

1. 适配你的目录结构的实现方式

你的目录结构如下:

/foo
  src/
    main.rs
    a.rs
    a/
       b.rs

此时不能直接在a.rs里写mod b {}——因为Rust默认会在src/目录下寻找b.rs或b/mod.rs,而非a/子目录。要让编译器定位到a/b.rs,需要在a.rs中用#[path]属性指定文件路径:

// a.rs
#[path = "a/b.rs"]
mod b;

// 后续可正常使用b模块的内容,比如b::xxx

2. 更符合Rust惯例的目录结构

Rust推荐的模块组织逻辑是:将模块a对应到src/a/目录,用src/a/mod.rs替代原来的src/a.rs,目录结构变为:

/foo
  src/
    main.rs
    a/
       mod.rs
       b.rs

这种情况下,在a/mod.rs里直接声明子模块即可,无需额外属性:

// a/mod.rs
mod b;

该方式完全遵循Rust默认的文件系统映射规则,代码结构更直观易维护。

3. Rust模块解析的核心原理

Rust的模块树与文件系统的映射遵循以下默认规则:

  • 当在某个模块中写mod xxx;时,编译器会在当前模块所在文件的同级目录下查找:
    1. xxx.rs文件,或者
    2. xxx/mod.rs文件(此时xxx是一个目录模块)
  • 如果子模块文件不在默认位置,就需要通过#[path = "路径"]属性手动指定文件位置,强制编译器到指定路径加载模块文件。

内容的提问来源于stack exchange,提问作者OscarRyz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.04 19:42:39