basic/crate-module/crate

[giscus[bot]]

basic/crate-module/crate

https://course.rs/basic/crate-module/crate.html

[0oYGZo0]

有些资料也叫crate是单元包，package是包，不过只是名称罢了

[jinliming2]

所以感觉还是保留英文原名比较好，可以在文章开头介绍的时候推荐翻译成啥名字，而文章中用原始的英文名字，这样不具备歧义。
不然看不同的文章，作者习惯于不同的翻译，看着就比较奇怪，特别是这种容易混淆的概念……

[ramonli]

确实，把package理解成项目怎么始终感觉别扭

[sunface]

大家说得有道理。。我想想怎么优化下吧，谢谢建议哈

[FlorentinoJink]

这几个单词记得住，可以不翻译，一翻译成中文反而混淆了

[yjshi2015]

建议跟其他语言做个横向类比，或者写个比喻，以免搞混。

[changuoqiang]

package既然是用来组织项目的，当年为什么不用project？

[yuhao00]

cargo是指集装箱里装的货物

crate代表箱子

package有软件包的意思，就是一堆软件打包放一起

命名的侧重点不同。

[Lartimes]

标新立异 。。。。 哎 ， 反而感觉。。

[Roxannej]

有的英文真的不太好翻译成中文，翻译过来总觉得怪怪的

[sunface]

确实，我后面会优化下

[ZLD1819858]

library crate和binary crate翻译过来怪怪的

[zcg0696]

WorkSpace不讲一下吗？

[xezzon]

可不可以这样类比：Nginx是一个package，其核心功能入口是lib.rs（库crate），然后分别有start、stop、restart等二进制create?

[ZLD1819858]

回答你这个问题之前还得了解Nginx，或许再抽象一点更好。

[ash0080]

这里我觉得作者有点小误会, 同一个 package 下的 bin crate, lib crate 是两个 crate,
那你就很容易理解 package 了, package 就是把至少一个到 N个crate(箱子) 再包在一起, 这样你就很好理解这里面的区别, 另外 crate与 package 也不一定非得同名

[csx12588]

本来不觉得混乱，看完摸不着头脑了，如果一个 Package 同时拥有 src/main.rs 和 src/lib.rs，那就意味着它包含两个包：库包和二进制包，这两个包名也都是 my-project —— 都与 Package 同名。

这两个包名，不是一个main.rs , 一个lib.rs吗，怎么都是my-project ，my-project怎么又与Package同名了？

[ZLD1819858]

• src/main.rs

  • binary crate的crate root
  • crate名与package名相同

• src/lib.rs

  • package包含一个library crate
  • library crate的crate root
  • crate名与package名相同

• Cargo把Crate root文件交给rustc构建library或binary

• 一个Package可以同时包含src/main.rs和src/lib.rs

  • 这就说明上面这个例子包含一个binary crate，一个library crate
  • 名称与package名相同

• 一个package可以有多个binary crate：

  • 文件放在src/bin
  • 每个文件是单独的binary crate

[ZLD1819858]

• src/main.rs

  • binary crate的crate root
  • crate名与package名相同

• src/lib.rs

  • package包含一个library crate
  • library crate的crate root
  • crate名与package名相同

• Cargo把Crate root文件交给rustc构建library或binary

• 一个Package可以同时包含src/main.rs和src/lib.rs

  • 这就说明上面这个例子包含一个binary crate，一个library crate
  • 名称与package名相同

• 一个package可以有多个binary crate：

  • 文件放在src/bin
  • 每个文件是单独的binary crate

[ZLD1819858]

个人觉得....还是不要包的包的叫比较好，毕竟package翻译是包，而大家指的包可能是一个crate，还是直接叫英文名吧.....这样也不容易混淆

[realth000]

有点晕，把crate理解成cmake或者makefile里的target好理解一些。

[sniper00]

package = visual studio 的 solution, crate = visual studio 的 project ?

[carzpurzkey]

感觉workspace像solution，package像project，crate像assembly，module像namespace？

[kapaseker]

我的天，这要是再学学，单词都不够用了。

[zhenzhenChange]

package:

• cargo new >>> bin crate
• cargo new --lib >>> lib crate

按照Rust的风格，一个package就是一个集装箱，里面可以装有N个不同类型的crate。

[donneyluck]

两句话就讲清了 给我看晕了

[whtblktone]

我自己把 crate 翻译成 构件

[Ervan0322]

一个package可以包含多个crate（一个lib crate和多个bin crate），然后多个package可以组成一个workspace。 可以这样理解吗？

[Ervan0322]

例如：

• workspace
  • package 1
    • src/main.rs(只有一个bin crate)
  • package 2
    • src/lib.rs (lib crate)
    • src/main.rs (bin crate)
    • src/bin/other_1.rs (other bin crate -- 编译时也会生成可执行文件)
    • src/bin/other_2.rs
  • package 3
    • src/lib.rs
    • src/main.rs
    • src/bin/other_1.rs
    • src/bin/other_2.rs
    • tests/this_is_a_test_file.rs (这些非src目录下的文件，是资源文件？)
    • ....

与此同时
workspace 下的Cargo.toml 文件将统一管理这些多个package的Cargo.toml

[zwl773993221]

可能是我太笨了或者没用看仔细，我只会单独使用：
$ cargo new my-project
或者
$ cargo new my-lib --lib
创建一个bin二进制包或者创建一个lib。如果我想创建类似下面的bin二进制包应该如何去做啊，感谢各位大佬：
.
├── Cargo.toml
├── Cargo.lock
├── src
│ ├── main.rs
│ ├── lib.rs
│ └── bin
│ └── main1.rs
│ └── main2.rs
├── tests
│ └── some_integration_tests.rs
├── benches
│ └── simple_bench.rs
└── examples
└── simple_example.rs

[zwl773993221]

嗨，我问了一下chatgpt，他给出了完整答案，解决了困恼几天的难题：

问题一：目录结构如下，使用cargo创建出以下目录结构的工程，并给出详细命令顺序和相关说明。
├── Cargo.toml
├── Cargo.lock
├── src
│ ├── main.rs
│ ├── lib.rs
│ └── bin
│ └── main1.rs
│ └── main2.rs
├── tests
│ └── some_integration_tests.rs
├── benches
│ └── simple_bench.rs
└── examples
└── simple_example.rs

要使用Cargo创建上述目录结构的项目，您需要按照以下步骤进行操作：

1.打开终端或命令提示符，并导航到您希望创建项目的目录中。
2.运行以下命令初始化Cargo项目：
cargo new --bin my_project
使用--bin标志来创建一个包含可执行文件的项目。这将创建一个名为my_project的新文件夹，并在其中初始化Cargo项目。
3.进入新创建的项目目录：
cd my_project
4.打开Cargo.toml文件，并添加项目的依赖项、特性等信息。根据您的项目需要进行适当的编辑。
5.创建src目录：
mkdir src
6.创建src/main.rs文件，并添加您的主要代码：
touch src/main.rs
在src/main.rs中添加您的Rust代码。
7.创建src/lib.rs文件并添加您的库代码（如果有）：
touch src/lib.rs
在src/lib.rs中添加您的库代码。
8.创建src/bin目录：
mkdir src/bin
9.创建src/bin/main1.rs和src/bin/main2.rs文件，并在每个文件中添加对应的代码：
touch src/bin/main1.rs
touch src/bin/main2.rs
在src/bin/main1.rs和src/bin/main2.rs中添加您的代码。
10.创建tests目录：
mkdir tests
11.创建tests/some_integration_tests.rs文件，并在其中添加集成测试代码：
touch tests/some_integration_tests.rs
在tests/some_integration_tests.rs中添加您的集成测试代码。
12.创建benches目录：
mkdir benches
13.创建benches/simple_bench.rs文件，并在其中添加基准测试代码：
touch benches/simple_bench.rs
在benches/simple_bench.rs中添加您的基准测试代码。
14.创建examples目录：
mkdir examples
15.创建examples/simple_example.rs文件，并在其中添加示例代码：
touch examples/simple_example.rs
在examples/simple_example.rs中添加您的示例代码。

完成以上步骤后，您的项目结构就会完整了。您可以根据需要在相应的文件中编写代码和测试。
请注意，这只是一个示例项目结构，您可以根据需要进行调整和扩展。有关更多Cargo命令和功能的详细信息，请参阅Cargo的官方文档。

问题二：是否修改Cargo.toml添加相关文件的关联性
ChatGPT
是的，您需要修改Cargo.toml文件来添加与项目中的文件结构相关的关联性。下面是您可以进行的一些修改：

1.添加与src/main.rs相关的关联性：
在Cargo.toml文件中的[package]部分下，添加以下行：
[[bin]]
name = "my_project"
path = "src/main.rs"
这将告诉Cargo将src/main.rs文件作为项目的主要可执行文件。
2.添加与src/lib.rs相关的关联性（如果有）：
在Cargo.toml文件中的[lib]部分下，添加以下行：
path = "src/lib.rs"
这将告诉Cargo将src/lib.rs文件作为项目的库文件。
3.添加与src/bin/main1.rs和src/bin/main2.rs相关的关联性：
在Cargo.toml文件中的[bin]部分下，添加以下行：
[[bin]]
name = "main1"
path = "src/bin/main1.rs"
[[bin]]
name = "main2"
path = "src/bin/main2.rs"
这将告诉Cargo将src/bin/main1.rs和src/bin/main2.rs文件分别作为项目中的两个可执行文件。

完成上述修改后，Cargo.toml文件的[package]部分可能如下所示：
[package]
name = "my_project"
version = "0.1.0"
edition = "2021"

[dependencies]

添加您的依赖项

[[bin]]
name = "my_project"
path = "src/main.rs"

[lib]

如果有的话，指定库文件路径：path = "src/lib.rs"

[[bin]]
name = "main1"
path = "src/bin/main1.rs"

[[bin]]
name = "main2"
path = "src/bin/main2.rs"

请根据您的项目结构和需要进行适当的修改。这样，Cargo将正确识别和构建与不同文件关联的可执行文件和库文件。

[ttsy1995]

工作空间

[ttsy1995]

➜ tree
├── add_one (462b)
│ ├── Cargo.toml (19b)
│ └── src (272b)
│ └── lib.rs (272b)
├── .idea (3.56KB)
│ ├── .gitignore (176b)
│ ├── workspace.xml (2.86KB)
│ ├── modules.xml (26b)
│ └── ttsy.iml (281b)
├── Cargo.toml (53b)
├── adder (384b)
│ ├── Cargo.toml (222b)
│ └── src (162b)
│ └── main.rs (162b)
└── Cargo.lock (1.96KB)

[ttsy1995]

根目录Cargo.lock下配置

[ttsy1995]

[workspace]

members = [
"adder",
"add_one"
]

[maquannene]

建议直接用英文名，只对英文名做一个中文概念描述就行了。

[geekac]

Rust程序设计语言里面，package翻译成包，crate不翻译。crate是Rust最小编译单位，有二进制和库两种形式。一个包可以有一个或者多个crate。这样更好理解点~

[lbx1979]

"有二进制和库两种形式"是可执行文件和库文件，都是二进制的

[jareguo]

使用 cargo run 可以运行该项目，输出：Hello, world!。

建议备注下，cd my-project 之后运行

[reatang]

看完我更迷糊了。。crate 和 package 我觉得是一个意思。。。

[reatang]

我的理解：

• 工作空间 workspace
  • 集合多个 package 的管理概念
• 包 package
  • package 管理一个到多个carte，也只是一个管理概念
• 单元包 carte
  • 单元包 carte 真实组织代码和代码关系的单元
• 模块 mod
  • 单元包内代码的载体，由单个文件或者一个带mod.rs文件的目录构成

[tinnkai]

例子给的太简单

[raotaohub]

看完确实更晕了，这个阶段代码都没有办法敲流畅，不如简单点解释，未来深入了再探究。

package: 含有1个以上crate的集合。
crate: rust最小编译单元，可以有lib.rs库文件 和 main.rs可执行文件 。

my_package/
├── Cargo.toml
├── src/
│   ├── main.rs     <-- 主 crate 的源文件
│   └── lib.rs      <-- 如果有的话，库 crate 的源文件
├── other_crate1/   <-- 其他 crate 1
│   ├── Cargo.toml  <-- 其他 crate 1 的元数据
│   └── src/
│       ├── my_mod.rs  <-- 其他 crate 1 中的模块
│       └── main.rs     <-- 其他 crate 1 的 main 或者 lib 文件
└── other_crate2/   <-- 其他 crate 2
    ├── Cargo.toml  <-- 其他 crate 2 的元数据
    └── src/
        ├── my_mod.rs  <-- 其他 crate 2 中的模块
        └── main.rs     <-- 其他 crate 2 的 main 或者 lib 文件

[add2ws]

这个水平还是别翻了吧，劝退了多少人

[Skyfacon]

学习打卡，再接再厉

[donneyluck]

说实话 这节讲的云里雾里

[mxhjhbrtggc]

确实，根本听不懂

[poshitou]

[ydong08]

遇到一个Crate的编译问题，无法理解，请各位大佬指点迷津，报错信息如下：

error[E0432]: unresolved import `chrono`
 --> refer/src/main.rs:1:5
  |
1 | use chrono::Utc;
  |     ^^^^^^ use of undeclared crate or module `chrono`

请问出错的原因是什么，如何解决这个编译问题？

测试代码目录结构如下：

.
├── Cargo.lock
├── Cargo.toml
└── refer
    ├── Cargo.toml
    └── src
        └── main.rs

3 directories, 4 files

一个workspace 仅包含一个二进制package(refer)，顶层workspace的Cargo.toml 的内容如下：

[package]
name = "workspace_db"
version.workspace = true
edition.workspace = true
authors.workspace = true

[[bin]]
name = "refer"
path = "refer/src/main.rs"

[workspace]
members = ["refer"]

[workspace.dependencies]
chrono = "0.4.38"

[workspace.package]
version = "0.1.0"
edition = "2021"
authors = ["[email protected]"]
license = "GPL"

二进制package 的refer/Cargo.toml 内容如下：

[package]
name = "refer"
version.workspace = true
edition.workspace = true
authors.workspace = true
license.workspace = true

[dependencies]
chrono.workspace = true

refer/src/main.rs的内容如下：

use chrono::Utc;

fn main() {
    println!("Hello, world! Now time {}", Utc::now());
}

[xlay666888]

这一章能看懂的，能有1%吗？

[kapaseker]

其实这张看不懂也没有太大关系，以为crate，package只是组织代码的一种形式，分别对应不同的产出物，多看看开源世界中的代码怎么解决某些问题就行了

[w123ok]

说实话，前面的章节都没有这章看的一头雾水，来自一个新手的困惑，不在于翻译的问题，而在于里面内在的逻辑关系。例如原文（是二进制包的根文件，该二进制包的包名跟所属 Package 相同，在这里都是 my-project）里面二进制包的包名从哪指定的，可变吗？toml文件中的name=my-project是在指定项目名吗？cargo new的时候创建的新文件夹my-project是项目名吗？cargo build后的可执行文件或包文件名称是由谁指定的，是toml文件中的name吗？ 一头雾水。。。。。

[kapaseker]

可以跳过，这章真没有那么重要，当你有组织代码的需求，你自然就明白了rust的这种方式。或者你看看一些开源的rust库源码就行了，照猫画虎OK的