Rust工作空间成员包为何无法在顶层main.rs中引用？

项目情况 #

项目目录结构：

 ~/rust/first
   src
  │  app
  │ │  src
  │ │ │  lib.rs
  │ │ └  entry.rs
  │ └  Cargo.toml
  └  main.rs
   Cargo.lock
   Cargo.toml

• 在src/app/src/entry.rs中定义了struct Entry{}
• 顶层Cargo.toml的[workspace]配置为members = ["src/app"]
• app子目录的Cargo.toml中[package]的name设为app

在顶层main.rs中编写let app = app::Entry::new();时，编译器报错：use of undeclared crate or module app``。添加app = { path = "./src/app" }到顶层依赖项后恢复正常，疑问点：

1. 为何仅声明工作空间成员不足以让顶层main.rs访问Entry？
2. 工作空间成员的作用是什么？
3. 遗漏了哪些配置？

问题解答 #

1. 仅声明工作空间成员无效的原因 #

工作空间只是将多个独立的Rust crate（包）纳入同一个管理环境，不会自动建立crate之间的代码引用关系。顶层的二进制crate（main.rs所在包）和子包app是完全独立的两个编译单元，要在一个crate中使用另一个crate的代码，必须显式添加依赖声明，哪怕它们同属一个工作空间。

2. 工作空间成员的核心作用 #

• 统一依赖管理：所有成员共享同一个Cargo.lock文件，避免不同子包依赖同一库的不同版本，减少编译冗余和版本冲突。
• 批量操作支持：在工作空间顶层执行cargo build、cargo test、cargo publish等命令时，会自动作用于所有成员包。
• 简化路径依赖：当成员包之间互相依赖时，工作空间会自动识别相对路径，无需手动填写完整路径，但依赖关系本身仍需显式声明。

3. 需补充的配置 #

要让顶层crate访问app的代码，需完成两步：

步骤1：在app子包中导出Entry

编辑src/app/src/lib.rs，将entry模块或Entry结构体设为公开：

// 方式1：导出entry模块
pub mod entry;

// 方式2：直接导出Entry，简化顶层调用
pub use entry::Entry;

步骤2：在顶层Cargo.toml中添加依赖

在[dependencies]区块添加：

app = { path = "./src/app" }

步骤3：在顶层main.rs中引入使用

根据导出方式选择对应的引入代码：

// 对应方式2的导出
use app::Entry;

// 或者对应方式1的导出
// use app::entry::Entry;

fn main() {
    let app = Entry::new();
}

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