@ -4,13 +4,13 @@
> < br >
> < br >
> commit 4f2dc564851dc04b271a2260c834643dfd86c724
> commit 4f2dc564851dc04b271a2260c834643dfd86c724
现在已经安装好了 Rust， 将遵循这个传统。Rust 已安好，让我们来编写第一个程序。当学习一门新语言的时候，使用该语言在屏幕上打印 “Hello, world!” 是一项传统，我们 将遵循这个传统。
> 注意：本书假设你熟悉基本的命令行操作。Rust 本身并不对你的编辑器，工具和你的代码存放在何处有什么特定的要求，所以如果你比起命令行更喜欢 IDE， 。
> 注意：本书假设你熟悉基本的命令行操作。对于你的编辑器、工具， ， ， 。
### 创建项目文件夹
### 创建项目文件夹
首先，创建一个文件夹来存放 Rust 代码。Rust 并不关心你的代码存放在哪里，不过在本书中，我们建议在你的 home 目录创建一个 *projects* 目录，并把你的所有项目放在这。打开一个终端并输入如下命令来为这个项目 创建一个文件夹：
首先，创建一个存放代码的文件夹。Rust 并不关心它的位置，不过在本书中，我们建议你在 home 目录中创建一个 *projects* 目录，并把你的所有项目放在这。打开一个终端，输入如下命令来 创建一个文件夹：
Linux 和 Mac:
Linux 和 Mac:
@ -32,9 +32,9 @@ Windows:
### 编写并运行 Rust 程序
### 编写并运行 Rust 程序
接下来，新建一个叫做 *main.rs* 的源文件。Rust 文件总是以 *.rs* 后缀结尾。如果文件名多于一个单词，使用下划线分隔它们。例如，使用 *my_program.rs* 而不是 *myprogram.rs* 。
接下来，新建一个叫做 *main.rs* 的文件。Rust 源*.rs* 后缀结尾。如果文件名包含多个单词，使用下划线分隔它们。例如 *my_program.rs* ， 而不是 *myprogram.rs* 。
现在打开刚创建的 *main.rs* 文件，并 输入如下代码：
现在打开刚创建的 *main.rs* 文件，输入如下代码：
< span class = "filename" > Filename: main.rs< / span > < span class = "filename" > Filename: main.rs< / span >
@ -52,11 +52,11 @@ $ ./main
Hello, world!
Hello, world!
```
```
在 Windows 上，运行`.\main.exe`而不是`./main`。不管使用何种系统，你应该在终端看到`Hello, world!`字符串。如果你做到了，那么恭喜你！你已经正式编写了一个 Rust 程序。你是一名 Rust 程序员了！欢迎入坑。
在 Windows 上，运行 `.\main.exe`， `Hello, world!` 字样。如果你做到了，恭喜你！你已经正式编写了一个 Rust 程序，成为一名 Rust 程序员！
### 分析 Rust 程序
### 分析 Rust 程序
现在， 里是谜题 的第一片：
现在，让我们回过头来， 是拼图 的第一片：
```rust
```rust
fn main() {
fn main() {
@ -64,35 +64,35 @@ fn main() {
}
}
```
```
这几行定义了一个 Rust ** 函数**。`main`函数是特殊的：这是每一个可执行的 Rust 程序首先运行的函数（译者注：入口点）。第一行表示“定义 一个叫 `main` 的函数，没有参数也没有返回值。”如果有参数的话，它们应该出现在括号中，`(`和`)` 。
这几行定义了一个 Rust ** 函数**。一个叫 `main` 的函数，没有参数也没有返回值。如果有参数的话，它们应该出现在括弧中，`(`和`)`之间。`main` 函数是特殊的：它是每一个可执行的 Rust 程序的入口点 。
同时注意函数体被包裹在大括号中，`{`和`}`。Rust 要求所有函数体都位于大括号中（译者注：对比有些语言特定情况可以省略大括号）。将前一个大括号与函数声明置于一行，并留有一个空格被认为是一个 好的代码风格。还 好的代码风格。
在`main()`函数中：
在 `main()` 函数
```rust
```rust
println!("Hello, world!");
println!("Hello, world!");
```
```
这行代码做了这个小程序的所有工作：它在屏幕上打印文本。这里有很多需要注意的细节。第一个是 Rust 代码风格使用 4 个空格缩进 ，而不是 1 个制表符（ ） 一行代码完成这个小程序的所有工作：在屏幕上打印文本。这里有很多细节需要注意。首先 Rust 使用 4 个空格的缩进风格 ，而不是 1 个制表符（ ）
第二个重要的部分是`println!()`。这叫做 Rust ** 宏**，是如何进行 Rust 元编程（ ） ， ： 函数。
第二个重要的部分是`println!()`。这是 ** 宏**， （ ） ， ： `!` 的时候，调用的是宏而不是普通 函数。
接下来，`"Hello, world!"` 是一个 ** 字符串**。我们把这个字符串作为一个参数传递给`println!`，它负责在屏幕上打印这个字符串。轻松加愉快！(⊙o⊙)
接下来，`"Hello, world!"` 是一个 ** 字符串**。我们把这个字符串作为一个参数传递给`println!`，它负责在屏幕上打印这个字符串。轻松加愉快！(⊙o⊙)
这一行以一个分号结尾（`;`）。`;`代表这 个表达式的结束和下一个表达式的开始。大部分 Rust 代码行以`;`结尾。该行以分号结尾（`;`）。`;` 代表一 个表达式的结束和下一个表达式的开始。大部分 Rust 代码行以 `;` 结尾。
### 编译和运行是两个步骤
### 编译和运行是两个步骤
在“编写并运行 Rust 程序”部分，展示了如何运行一个新创建的程序。现在我们将拆分并检查每一步操作。
在“编写并运行 Rust 程序”部分，展示了如何运行一个新创建的程序。现在我们将拆分并检查每一步操作。
在 运行一个 Rust 程序之前，必须先编译它。可以输入`rustc`命令来使用 Rust 编译器并像这样传递源文件的名字 ： 运行一个 Rust 程序之前，必须先编译它。可以通过 `rustc` 命令来使用 Rust 编译器，并传递源文件的名字给它，如下 ：
```
```
$ rustc main.rs
$ rustc main.rs
```
```
如果你来自 C 或 C++ 背景，就会发现这与`gcc`和`clang` 类似。编译成功后，
如果你有 C 或 C++ 背景，就会发现这与 `gcc` 和 `clang` 类似。编译成功后，
```
```
$ ls
$ ls
@ -107,7 +107,7 @@ main.exe
main.rs
main.rs
```
```
这表示我们有两个文件：*.rs* 后缀的源文件，和可执行文件（在 Windows下是 *main.exe* ，其它平台是 *main* ）。这里剩下的操作就只有 运行 *main* 或 *main.exe* 文件了 ，像这样：
这表示我们有两个文件：*.rs* 后缀的源文件，和可执行文件（在 Windows下是 *main.exe* ，其它平台是 *main* ）。然后 运行 *main* 或 *main.exe* 文件，像这样：
```
```
$ ./main # or .\main.exe on Windows
$ ./main # or .\main.exe on Windows
@ -115,27 +115,27 @@ $ ./main # or .\main.exe on Windows
如果 *main.rs* 是我们的“Hello, world!”程序，它将会在终端上打印`Hello, world!`。
如果 *main.rs* 是我们的“Hello, world!”程序，它将会在终端上打印`Hello, world!`。
来自 Ruby、Python 或 JavaScript 这样的动态类型语言背景的同学，可能不太习惯在分开的步骤编译和执行程序。Rust 是一种 ** 静态提前编译 语言**（ 可以 编译好程序后，把它给任何人，他们都 不需要安装 Rust 就可运行。如果你给他们一个 `.rb` ， `.py` 或 `.js` 文件，他们需要先分别安装 Ruby， ， （ ， ） ，
来自 Ruby、Python 或 JavaScript 这样的动态类型语言背景的同学，可能不太习惯将编译和执行分为两个步骤。Rust 是一种 ** 预编译静态类型 语言**（ `.rb` ， `.py` 或 `.js` 文件，他们需要先分别安装 Ruby， ， （ ， ） ， 上 的权衡取舍。
仅仅 使用`rustc`编译简单程序是没问题的，不过随着项目的增长，你将想要能够控制你项目拥有的所有选项 ，并使其易于分享你的代码给别人或别的项目。接下来，我们将介绍一个叫做 Cargo 的工具，它将帮助你编写现实生活 中的 Rust 程序。使用 `rustc` 编译简单程序是没问题的，不过随着项目的增长，你将想要能够控制你项目的方方面面 ，并使其易于分享你的代码给别人或别的项目。接下来，我们将介绍一个叫做 Cargo 的工具，它将帮助你编写真实世界 中的 Rust 程序。
## Hello, Cargo!
## Hello, Cargo!
Cargo 是 Rust 的构建系统和包管理工具，同时 Rustacean 们使用 Cargo 来管理他们的 Rust 项目，因为 它使得很多任务变得更轻松。例如， 代码 依赖的 库并编译这些库 。我们把代码需要的库叫做 ** 依赖**（
Cargo 是 Rust 的构建系统和包管理工具，同时 Rustacean 们使用 Cargo 来管理他们的 Rust 项目， ， ** 依赖**（
最简单的 Rust 程序，例如我们刚刚编写的，并没有任何依赖，所以目前我们只使用了 Cargo 负责构建代码的那一部分。随着编写更加复杂的 Rust 程序 ，你会想要添加依赖，如果你使用 Cargo 开始的话，这将会变得简单许多。
最简单的 Rust 程序，比如我们刚刚编写的，并没有任何依赖，所以我们只使用了 Cargo 构建代码的功能。随着更复杂程序的编写 ，你会想要添加依赖，如果你使用 Cargo 开始的话，这将会变得简单许多。
由于绝大部分 Rust 项目使用 Cargo， 安装章节介绍的官方安装包的话， 检查是否安装了 Cargo：
由于绝大部分 Rust 项目使用 Cargo， 之前介绍的官方安装包的话，它自带 Cargo。如果通过其他方式安装的话， ， 检查是否安装了 Cargo：
```
```
$ cargo --version
$ cargo --version
```
```
如果出现了版本号，一切 OK！ 一个类似“`command not found`”的错误，那么你应该查看安装方式的文档来 确定如何单独安装 Cargo。
如果出现了版本号，一切 OK！ 类似“`command not found`”的错误，你应该查看安装文档以 确定如何单独安装 Cargo。
### 使用 Cargo 创建项目
### 使用 Cargo 创建项目
让我们使用 Cargo 来创建一个新项目并 看看与上面的`hello_world`项目有什么不同。回到 projects 目录（或者任何你决定 放置代码的目录）：
让我们使用 Cargo 来创建一个新项目，然后 看看与上面的`hello_world`项目有什么不同。回到 projects 目录（或者任何你放置代码的目录）：
Linux 和 Mac:
Linux 和 Mac:
@ -156,11 +156,11 @@ $ cargo new hello_cargo --bin
$ cd hello_cargo
$ cd hello_cargo
```
```
我们向`cargo new`传递了`--bin`因为我们的目标是生成一个可执行程序，而不是一个库。可执行文件 是二进制可执行文件，通常就叫做 ** 二进制文件**（
我们向 `cargo new` 传递了 `--bin`， 程序 是二进制可执行文件，通常就叫做 ** 二进制文件**（
如果列出 *hello_cargo* 目录中的文件，将会看到 Cargo 生成了一个文件和一个目录：一个 *Cargo.toml* 文件和一个 *src* 目录，*main.rs* 文件位于目录中。它也在 *hello_cargo* 目录初始化了一个 git 仓库，以及一个 *.gitignore* 文件；你可以改为使用不同的版本控制系统（ ） ， ， 。
如果列出 *hello_cargo* 目录中的文件，将会看到 Cargo 生成了一个文件和一个目录：一个 *Cargo.toml* 文件和一个 *src* 目录，*main.rs* 文件位于目录中。它也在 *hello_cargo* 目录初始化了一个 git 仓库，以及一个 *.gitignore* 文件；你可以通过`--vcs`参数， （ ） ， 。
使用你选择的 文本编辑器（ ） *Cargo.toml* 文件。它应该看起来像这样：
使用文本编辑器（ ） *Cargo.toml* 文件。它应该看起来像这样：
< span class = "filename" > Filename: Cargo.toml< / span > < span class = "filename" > Filename: Cargo.toml< / span >
@ -173,13 +173,13 @@ authors = ["Your Name <you@example.com>"]
[dependencies]
[dependencies]
```
```
这个文件使用[*TOML*][toml]<!-- ignore --> (Tom's Obvious, Minimal Language) 格式。TOML 类似于 INI， ，
这个文件使用 [*TOML*][toml]<!-- ignore --> (Tom's Obvious, Minimal Language) 格式。TOML 类似于 INI， ，
[toml]: https://github.com/toml-lang/toml
[toml]: https://github.com/toml-lang/toml
第一行，`[package]`，是一个部分标题 表明下面的语句用来配置一个包。随着我们在这个文件增加更多的信息，还将增加其他部分 。
第一行，`[package]`，是一个段落标题， 表明下面的语句用来配置一个包。随着我们在这个文件增加更多的信息，还将增加其他段落 。
最后一行，`[dependencies]`，是列出项目依赖的 *crates* （我们这么称呼 Rust 代码包）的部分的开始，这样 Cargo 也就知道去 下载和编译它们了。这个项目并不需要任何其他的 crate，
最后一行，`[dependencies]`，是项目依赖的 *crates* （ 下载和编译它们了。这个项目并不需要任何其他的 crate，
现在看看 *src/main.rs* ：
现在看看 *src/main.rs* ：
@ -191,14 +191,14 @@ fn main() {
}
}
```
```
Cargo 为你生成了一个“Hello World!”，正如我们之前编写的那个！目前为止我们所见过的之前项目与 Cargo 生成的 项目区别有：
Cargo 为你生成了一个“Hello World!”，正如我们之前编写的那个！目前为止，之前项目与 Cargo 生成 项目区别有：
- 代码位于 *src* 目录
- 代码位于 *src* 目录
- 项目根目录包含一个 *Cargo.toml* 配置文件
- 项目根目录包含一个 *Cargo.toml* 配置文件
Cargo 期望源文件位于 *src* 目录，这样 将项目根目录留给 README、license 信息、配置文件和其他跟代码无关的文件。这样， 。 一切井井有条。
Cargo 期望源文件位于 *src* 目录，将项目根目录留给 README、license 信息、配置文件和其他跟代码无关的文件。这样， ，
如果没有使用 Cargo 开始项目，正如在 *hello_world* 目录中的项目，可以把它转化为一个使用 Cargo 的项目， 通过将代码放入 *src* 目录并创建一个合适的 *Cargo.toml* 。
如果没有用 Cargo 创建项目，比如 *hello_world* 目录中的项目，可以通过将代码放入 *src* 目录， *Cargo.toml* ，将其转化为一个 Cargo 项目 。
### 构建并运行 Cargo 项目
### 构建并运行 Cargo 项目
@ -218,7 +218,7 @@ Hello, world!
好的！如果一切顺利，`Hello, world!`应该再次打印在终端上。
好的！如果一切顺利，`Hello, world!`应该再次打印在终端上。
第一次运行`cargo build`的时候也会使 Cargo 在项目根目录创建一个叫做 *Cargo.lock* 的新文件 ，它看起来像这样：首次运行 `cargo build` 的时候， ，它看起来像这样：
< span class = "filename" > Filename: Cargo.lock< / span > < span class = "filename" > Filename: Cargo.lock< / span >
@ -228,9 +228,9 @@ name = "hello_cargo"
version = "0.1.0"
version = "0.1.0"
```
```
Cargo 使用 *Cargo.lock* 来记录程序的依赖。这个项目并没有依赖，所以内容有一点稀少。事实上，你自己永远也不需要碰这个文件；仅仅 让 Cargo 处理它就行了。
Cargo 使用 *Cargo.lock* 来记录程序的依赖。这个项目并没有依赖，所以内容比较少。事实上，你自己永远也不需要碰这个文件， 让 Cargo 处理它就行了。
我们刚刚使用`cargo build`构建了项目并使用`./target/debug/hello_cargo`运行了它，不过 也可以使用`cargo run`编译并运行：
我们刚刚使用 `cargo build` 构建了项目并使用 `./target/debug/hello_cargo` 运行了它，也可以使用 `cargo run` 编译并运行：
```
```
$ cargo run
$ cargo run
@ -238,7 +238,7 @@ $ cargo run
Hello, world!
Hello, world!
```
```
注意这一次，并没有出现告诉我们 Cargo 正在编译 `hello_cargo` 的输出。Cargo 发现文件并没有被改变，所以只是 运行了二进制文件。如果修改了源文件的话，将会出现像这样的输出：
注意这一次，并没有出现告诉我们 Cargo 正在编译 `hello_cargo` 的输出。Cargo 发现文件并没有被改变，直接 运行了二进制文件。如果修改了源文件的话，将会出现像这样的输出：
```
```
$ cargo run
$ cargo run
@ -247,12 +247,12 @@ $ cargo run
Hello, world!
Hello, world!
```
```
所以现在又出现一些 更多的不同：
所以现在又出现更多的不同：
- 使用`cargo build`构建项目（或使用`cargo run`一步构建并运行），而不是使用`rustc`
- 使用 `cargo build` 构建项目（或使用 `cargo run` 一步构建并运行），而不是使用`rustc`
- 不同于将构建结果放在源码相同目录， *target/debug* 目录中的文件 。
- 有别于将构建结果放在源码目录， *target/debug* 目录 。
Cargo 的另一个优点是不管你使用什么操作系统它的命令都是一样的，所以之后我们将不再为 Linux 和 Mac 以及 Windows 提供特定 的命令。
Cargo 的另一个优点是， ， 相应 的命令。
### 发布构建
### 发布构建
@ -260,7 +260,7 @@ Cargo 的另一个优点是不管你使用什么操作系统它的命令都是
### 把 Cargo 当作习惯
### 把 Cargo 当作习惯
对于简单项目， Cargo 并不能比`rustc`提供更多的价值，不过随着开发的进行终将体现它的价值。对于拥有多个 crate 的复杂项目，让 Cargo 来协调构建将更简单。有了 Cargo， 现在也它使用了很多之后你的 Rust 程序生涯将会用得上的实用工具。事实上，无形中你可以使用下面的命令开始所有你想要从事的项目 ：
对于简单项目， Cargo 并不能比`rustc`提供更多的价值，不过随着开发的进行终将体现它的价值。对于拥有多个 crate 的复杂项目，让 Cargo 来协调构建将更简单。有了 Cargo， 也它使用了很多你之后的 Rust 生涯将会用得上的实用工具。其实你可以开始任何你想要从事的项目，使用下面的命令 ：
```
```
$ git clone someurl.com/someproject
$ git clone someurl.com/someproject
@ -268,6 +268,6 @@ $ cd someproject
$ cargo build
$ cargo build
```
```
> 注意：如果你想要查看 Cargo 的更多 细节，请阅读官方的 [Cargo guide]，它覆盖了其 所有的功能。
> 注意：如果想要了解 Cargo 更多的 细节，请阅读官方的 [Cargo guide]，它覆盖了所有的功能。
[Cargo guide]: http://doc.crates.io/guide.html
[Cargo guide]: http://doc.crates.io/guide.html
KaiserY
8 years ago
committed by
GitHub