Rust构建单二进制可执行文件时出现模块未声明错误如何解决

错误产生的两个核心原因 #

• 你的二进制crate根是main.rs，你没有在根模块中声明fasta_multiple_cmp子模块，编译器无法识别该模块。放在src目录下的mod.rs不会自动被main.rs加载，只有目录级子模块或者库crate的根声明才需要mod.rs。
• 你在fasta_multiple_cmp.rs、build_sequences_matrix.rs中额外嵌套了一层和文件名同名的mod，会导致模块路径多了一层冗余层级，就算模块声明正确也无法正常调用函数。

修复步骤 #

1. 删除src目录下的mod.rs，在main.rs顶部添加子模块声明：

// 声明根模块下的两个子模块
mod fasta_multiple_cmp;
mod build_sequences_matrix;

use fasta_multiple_cmp::get_filenames;

fn main() {
    get_filenames();
}

2. 移除fasta_multiple_cmp.rs中冗余的mod嵌套，直接在文件根级别写代码，同时补全遗漏的std::env导入：

use std::env;

pub fn get_filenames() {
    let args: Vec<String> = env::args().collect();
    // 原有逻辑
}

3. 同理移除build_sequences_matrix.rs中冗余的mod嵌套：

use simple_matrix::Matrix;
// 原有逻辑直接写在文件根级别即可

修改完成后重新执行cargo build即可正常编译。

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