0Pricing
Learn Rust Coding · 课时

工作空间

多 Crate 项目

工作空间 是 CoddyKit 上的免费 Learn Rust Coding 课时。 这是第 3 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Learn Rust Coding 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Learn Rust Coding 课程共包含 4 节课。

什么是工作空间?

工作空间是一组相关的包,它们共享一个 Cargo.lock 和一个通用的 target 目录。这是管理多包项目的标准方式。

根清单

工作空间根目录包含一个 Cargo.toml,其中的 [workspace] 表会列出成员包。根目录本身通常没有包。

[workspace]
members = ["app", "core", "utils"]
resolver = "2"

工作空间布局

一种典型的布局是将每个 crate 放在自己的子目录中:

  • Cargo.toml — 工作区根目录
  • app/ — 二进制 crate
  • core/ — 库 crate
  • utils/ — 另一个库 crate

创建成员

您可以像创建任何 crate 一样创建成员,然后将它们添加到根清单的 members 列表中。

cargo new app
cargo new core --lib
cargo new utils --lib

依赖成员

一个成员 crate 可以在自己的 Cargo.toml 中使用 path 依赖来依赖另一个成员。

[dependencies]
core = { path = "../core" }
utils = { path = "../utils" }

跨 crate 调用

可以通过引用 crate 名称,在另一个 crate 中使用某个 crate 的公共项。这里,core 暴露了一个由二进制 crate 调用的函数。

// in core/src/lib.rs
pub fn greeting(name: &str) -> String {
    format!("Hello, {name}!")
}

// in app/src/main.rs
fn main() {
    let msg = core::greeting("workspace");
    println!("{msg}");
}

构建整个工作区

在根目录运行 Cargo 会构建每个成员。共享的 target 目录意味着公共依赖只需编译一次。

cargo build
cargo test

指定一个成员

使用 -p(或 --package)为单个成员 crate 运行命令。

cargo run -p app
cargo test -p core

工作区依赖

在 [workspace.dependencies] 下统一定义版本,然后从各个成员中引用它们,以保持版本同步。

# root Cargo.toml
[workspace.dependencies]
serde = "1.0"

# member Cargo.toml
[dependencies]
serde = { workspace = true }

为什么使用工作区

工作区的优点:

  • 使用单个共享锁定文件,确保版本一致
  • 通过共享的目标目录加快构建速度
  • 可以轻松将大型项目拆分为职责明确的 crate
  • 一条命令即可构建并测试所有内容

排除目录

exclude 键可以将特定目录排除在工作区之外,而 default-members 则设置未传递 -p 时运行的 crate。

[workspace]
members = ["app", "core"]
exclude = ["experiments"]
default-members = ["app"]

快速检查

工作区中的所有 crate 共享什么?

回顾

您学习了工作区:

  • [workspace] 表列出成员
  • 成员通过 path 相互依赖
  • 共享的锁定文件和目标目录可以加快构建速度
  • 使用 -p 指定一个成员
  • [workspace.dependencies] 集中管理版本

常见问题解答

「工作空间」课时是免费的吗?

是的 — 「工作空间」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Learn Rust Coding 课程的其余内容,请升级到 CoddyKit PRO。 Learn Rust Coding 课程共包含 4 节课。

「工作空间」这节课中我会学到什么?

多 Crate 项目 你通过在浏览器中直接运行的动手代码来练习 Learn Rust Coding,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Learn Rust Coding 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Learn Rust Coding 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 3 节课,共 4 节。

「工作空间」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Learn Rust Coding 课中编写并运行代码吗?

能。每节 Learn Rust Coding 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. Cargo 基础
  2. Cargo.toml
  3. 工作空间
  4. 特性与配置文件
← 返回 Learn Rust Coding