Rust配置独立lib target后，私有lib模块报错的解决方案咨询

问题背景 #

我正在开发一个Rust二进制应用，初始文件结构如下：

src
|- data_access_layer.rs
|- main.rs
|- lib
   |- util.rs

为了在集成测试中导出data_access_layer的助手函数，我在Cargo.toml中添加了[lib]配置，指向src/test_lib.rs，该文件内容为：

// test_lib.rs
pub mod data_access_layer;

新增src/test_lib.rs后，运行或测试应用时出现错误："could not find lib in the crate root"。当前Cargo.toml配置如下：

[package]
name = "api-service"
version = "0.11.14"
edition = "2018"

[dependencies]
diesel = { version = "2", features = ["mysql", "extras", "chrono", "r2d2"] }

[dev-dependencies]
pretty_assertions = "1.2.1"

[lib]
name = "test_lib"
path = "src/test_lib.rs"

想咨询该如何处理此问题？使用lib作为私有模块目录名是否不妥？我原本以为TOML配置可释放lib名称供使用。

解决方法 #

1. 更换私有模块目录名 #

Rust的Cargo工具默认将src/lib.rs识别为库crate的入口文件，即便你在Cargo.toml中指定了自定义库入口，lib这个名称仍会被Cargo优先关联到默认库逻辑，导致私有lib目录被误解析。因此不要用lib作为私有模块目录名，建议改为utils、helpers这类不会和Cargo默认规则冲突的名称。

修改后的文件结构：

src
|- data_access_layer.rs
|- main.rs
|- utils
   |- util.rs

随后在需要引用的文件（比如main.rs）中调整导入路径：

// main.rs
mod utils;
use utils::util;

2. 修复现有lib目录的模块声明（不推荐） #

如果暂时不想修改目录名，需在lib目录下添加mod.rs文件声明模块，并在主文件中明确导入：

• 在src/lib/下创建mod.rs：

// src/lib/mod.rs
pub mod util;

• 在main.rs中导入该模块：

// main.rs
mod lib;
use lib::util;

这种方法容易和Cargo默认库规则混淆，长期维护存在隐患，不建议使用。

3. 确保测试库的模块引用路径正确 #

你的test_lib.rs中引用data_access_layer的写法是正确的（因为该文件位于src根目录），后续如果调整文件结构，要注意使用相对路径或绝对路径保证引用有效。

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