mirror of
https://github.com/KaiserY/trpl-zh-cn
synced 2024-11-09 00:43:59 +08:00
第一章校订完成
This commit is contained in:
murphy
parent
1f2533ae4d
commit
6081f64d20
@ -4,22 +4,22 @@
|
||||
> <br>
|
||||
> commit 62f78bb3f7c222b574ff547d0161c2533691f9b4
|
||||
|
||||
欢迎阅读“Rust 程序设计语言”，一本关于 Rust 的介绍性书籍。Rust 是一个着用于安全、速度和并发的编程语言。它的设计不仅可以使程序获得性能和对底层语言的控制，并且能够享受高级语言强大的抽象能力。这些特性使得 Rust 适合那些有类似 C 语言经验并正在寻找一个更安全的替代者的程序员，同时也适合那些来自类似 Python 语言背景，正在探索在不牺牲表现力的情况下编写更好性能代码的开发者。
|
||||
欢迎阅读“Rust 程序设计语言”，一本介绍 Rust 的书。Rust 是一门着眼于安全、速度和并发的编程语言。它的设计兼顾性能与底层控制，以及高级语言强大的抽象能力。适合那些有类 C 语言经验，正在寻找更安全的替代品的开发者；以及有着类 Python 语言背景，寻求在不牺牲表现力的前提下，编写性能更好的代码的开发者。
|
||||
|
||||
Rust 在编译时进行其绝大多数的安全检查和内存管理决策，因此程序的运行时性能没有受到影响。这让其在许多其他语言不擅长的应用场景中得以大显身手：存在可预测空间和时间要求的程序，嵌入到其他语言中，以及编写底层代码，如设备驱动和操作系统。Rust 也很擅长 web 程序：它驱动着 Rust 包注册网站（package
|
||||
registry site），[crates.io]！我们期待看到**你**使用 Rust 进行创作。
|
||||
Rust 主要在编译时执行安全检查和内存管理决策，对运行时性能的影响微不足道。这使其在许多语言不擅长的应用场景中得以大显身手：空间和时间需求可预测的程序，嵌入到其他语言中，以及编写底层代码，如设备驱动和操作系统。Rust 也很擅长 web 程序：它驱动着 Rust 包注册网站（package
|
||||
registry site），[crates.io]！我们期待**你**使用 Rust 进行创作。
|
||||
|
||||
[crates.io]: https://crates.io/
|
||||
|
||||
本书是为已经至少了解一门编程语言的读者而写的。读完本书之后，你应该能自如的编写 Rust 程序。我们将通过小而集中并且相互依赖的例子来学习 Rust，并向你展示如何使用 Rust 多样的功能，同时了解它们在幕后是如何执行的。
|
||||
本书的目标读者至少应了解一门其它编程语言。读完本书之后，你应该能自如的编写 Rust 程序。我们将通过短小精干、前后呼应的例子来学习 Rust，并展示其多样功能的使用方法，同时了解幕后如何运行。
|
||||
|
||||
## 为本书做出贡献
|
||||
|
||||
本书是开源的。如果你发现任何错误，请不要犹豫，[在 GitHub 上][on GitHub]发起 issue 或提交 pull request。请查看[CONTRIBUTING.md]获取更多信息。
|
||||
本书是开源的。如果你发现任何错误，不要犹豫，[在 GitHub 上][on GitHub]发起 issue 或提交 pull request。请查看 [CONTRIBUTING.md] 获取更多信息。
|
||||
|
||||
[on GitHub]: https://github.com/rust-lang/book
|
||||
[CONTRIBUTING.md]: https://github.com/rust-lang/book/blob/master/CONTRIBUTING.md
|
||||
|
||||
> 译者注：这是本译本的 [GitHub 仓库][trpl-zh-cn]，同样欢迎 Issue 和 PR :)
|
||||
> 译者注：译本的 [GitHub 仓库][trpl-zh-cn]，同样欢迎 Issue 和 PR :)
|
||||
|
||||
[trpl-zh-cn]: https://github.com/KaiserY/trpl-zh-cn
|
||||
@ -4,40 +4,40 @@
|
||||
> <br>
|
||||
> commit c1b95a18dbcbb06aadf07c03759f27d88ccf62cf
|
||||
|
||||
使用 Rust 的第一步是安装。你需要网络连接来执行本章的命令，因为我们要从网上下载 Rust。
|
||||
第一步是安装 Rust。你需要网络连接来执行本章的命令，因为我们要从网上下载 Rust。
|
||||
|
||||
我们将会展示很多使用终端的命令，并且这些代码都以`$`开头。并不需要真正输入`$`，它们在这里代表每行指令的开头。在网上会看到很多使用这个惯例的教程和例子：`$`代表以常规用户运行命令，`#`代表需要用管理员运行的命令。没有以`$`（或`#`）的行通常是之前命令的输出。
|
||||
我们将会展示很多在终端中输入的命令，这些命令均以 `$` 开头。你不需要真的输入`$`，在这里它代表每行命令的起始。网上有很多教程和例子遵循这种惯例：`$` 代表以常规用户身份运行命令，`#` 代表需要用管理员身份运行命令。没有以 `$`（或 `#`）起始的行通常是之前命令的输出。
|
||||
|
||||
### 在 Linux 或 Mac 上安装
|
||||
|
||||
如果你使用 Linux 或 Mac，所有需要做的就是打开一个终端并输入：
|
||||
如果你使用 Linux 或 Mac，你需要做的全部，就是打开一个终端并输入：
|
||||
|
||||
```
|
||||
$ curl https://sh.rustup.rs -sSf | sh
|
||||
```
|
||||
|
||||
这会下载一个脚本并开始安装。你可能被提示要输入密码。如果一切顺利，将会出现如下内容：
|
||||
这会下载一个脚本并开始安装。可能会提示你输入密码，如果一切顺利，将会出现如下内容：
|
||||
|
||||
```
|
||||
Rust is installed now. Great!
|
||||
```
|
||||
|
||||
当然，如果你不赞成`curl | sh`这种模式，可以随意下载、检查和运行这个脚本。
|
||||
当然，如果你对于 `curl | sh` 心有疑虑，你可以随意下载、检查和运行这个脚本。
|
||||
|
||||
### 在 Windows 上安装
|
||||
|
||||
在 Windows 上，前往[https://rustup.rs](https://rustup.rs/)<!-- ignore -->并按照说明下载 rustup-init.exe。运行并遵循其提供的其余指示操作。
|
||||
如果你使用 Windows，前往 [https://rustup.rs](https://rustup.rs/)<!-- ignore -->，按说明下载 rustup-init.exe，运行并照其指示操作。
|
||||
|
||||
本书其余 Windows 相关的命令假设你使用`cmd`作为你的 shell。如果你使用不同的 shell，可能能够执行 Linux 和 Mac 用户相同的命令。如果都不行，请查看所使用的 shell 的文档。
|
||||
本书中其余 Windows 相关的命令，假设你使用 `cmd` 作为 shell。如果你使用其它 shell，也许可以执行与 Linux 和 Mac 用户相同的命令。如果不行，请查看该 shell 的文档。
|
||||
|
||||
### 自定义安装
|
||||
|
||||
如果有理由倾向于不使用 rustup.rs，请查看[Rust 安装页面](https://www.rust-lang.org/install.html)获取其他选择。
|
||||
无论出于何种理由，如果不愿意使用 rustup.rs，请查看 [Rust 安装页面](https://www.rust-lang.org/install.html) 获取其他选择。
|
||||
|
||||
|
||||
### 更新
|
||||
|
||||
一旦安装完 Rust，更新到最新版本是简单的。在 shell 中运行更新脚本：
|
||||
一旦 Rust 安装完，更新到最新版本很简单。在 shell 中执行：
|
||||
|
||||
```
|
||||
$ rustup update
|
||||
@ -45,7 +45,7 @@ $ rustup update
|
||||
|
||||
### 卸载
|
||||
|
||||
卸载 Rust 同安装一样简单。在 shell 中运行卸载脚本
|
||||
卸载 Rust 同样简单。在 shell 中执行:
|
||||
|
||||
```
|
||||
$ rustup self uninstall
|
||||
@ -53,25 +53,25 @@ $ rustup self uninstall
|
||||
|
||||
### 故障排除
|
||||
|
||||
安装完 Rust 后，打开 shell，输入：
|
||||
安装完 Rust 后，在 shell 中执行：
|
||||
|
||||
```
|
||||
$ rustc --version
|
||||
```
|
||||
|
||||
应该能看到类似这样的版本号、提交 hash 和提交日期，对应你安装时的最新稳定版本：
|
||||
应该能看到类似这样的版本号、提交哈希和提交日期，对应安装时的最新稳定版：
|
||||
|
||||
```
|
||||
rustc x.y.z (abcabcabc yyyy-mm-dd)
|
||||
```
|
||||
|
||||
如果出现这些内容，Rust 就安装成功了！
|
||||
出现这些内容，Rust 就安装成功了！
|
||||
|
||||
恭喜入坑！（此处应该有掌声！）
|
||||
|
||||
如果有问题并且你在使用 Windows，检查 Rust（rustc，cargo 等）是否位于`%PATH%`系统变量中。
|
||||
如果在 Windows 中使用出现问题，检查 Rust（rustc，cargo 等）是否在 `%PATH%` 环境变量所包含的路径中。
|
||||
|
||||
如果还是不能运行，有许多可以获取帮助的地方。最简单的是 [irc.mozilla.org 上的 #rust IRC 频道][irc]<!-- ignore --> ，可以使用 [Mibbit][mibbit] 来访问它。访问这些地址然后就可以和其他能提供帮助的 Rustacean（我们这些人自嘲的绰号）聊天了。其它给力的资源包括[用户论坛][users]和 [Stack Overflow][stackoverflow]。
|
||||
如果还是不能解决，有许多地方可以求助。最简单的是 [irc.mozilla.org 上的 #rust IRC 频道][irc]<!-- ignore --> ，可以使用 [Mibbit][mibbit] 来访问它。然后就能和其他 Rustacean（Rust 用户的称号，有自嘲意味）聊天并寻求帮助。其它给力的资源包括[用户论坛][users]和 [Stack Overflow][stackoverflow]。
|
||||
|
||||
[irc]: irc://irc.mozilla.org/#rust
|
||||
[mibbit]: http://chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust
|
||||
@ -80,6 +80,6 @@ rustc x.y.z (abcabcabc yyyy-mm-dd)
|
||||
|
||||
### 本地文档
|
||||
|
||||
安装程序也包含一份本地文档的拷贝，你可以离线阅读它们。输入`rustup doc`将在浏览器中打开本地文档。
|
||||
安装程序自带本地文档，可以离线阅读。输入 `rustup doc` 可以在浏览器中查看。
|
||||
|
||||
任何你不太确认标准库中提供的类型或函数是干什么的时候，请查看 API 文档！
|
||||
任何时候，如果你拿不准标准库中类型或函数，请查看 API 文档！
|
||||
@ -4,13 +4,13 @@
|
||||
> <br>
|
||||
> commit 4f2dc564851dc04b271a2260c834643dfd86c724
|
||||
|
||||
现在已经安装好了 Rust，让我们来编写第一个 Rust 程序。当学习一门新语言的时候，使用该语言在屏幕上打印 “Hello, world!” 是一个传统，我们将遵循这个传统。
|
||||
Rust 已安好，让我们来编写第一个程序。当学习一门新语言的时候，使用该语言在屏幕上打印 “Hello, world!” 是一项传统，我们将遵循这个传统。
|
||||
|
||||
> 注意：本书假设你熟悉基本的命令行操作。Rust 本身并不对你的编辑器，工具和你的代码存放在何处有什么特定的要求，所以如果你更喜欢 IDE，请随意选择你喜欢的 IDE。
|
||||
> 注意：本书假设你熟悉基本的命令行操作。对于你的编辑器、工具，以及你的代码存在何处，Rust 并没有特殊要求，如果你更喜欢 IDE，请随意。
|
||||
|
||||
### 创建项目文件夹
|
||||
|
||||
首先，创建一个文件夹来存放 Rust 代码。Rust 并不关心你的代码存放在哪里，不过在本书中，我们建议在你的 home 目录创建一个 *projects* 目录，并把你的所有项目放在这。打开一个终端，输入如下命令来为项目创建一个文件夹：
|
||||
首先，创建一个存放代码的文件夹。Rust 并不关心它的位置，不过在本书中，我们建议你在 home 目录中创建一个 *projects* 目录，并把你的所有项目放在这。打开一个终端，输入如下命令来创建一个文件夹：
|
||||
|
||||
Linux 和 Mac:
|
||||
|
||||
@ -32,9 +32,9 @@ Windows:
|
||||
|
||||
### 编写并运行 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>
|
||||
|
||||
@ -52,11 +52,11 @@ $ ./main
|
||||
Hello, world!
|
||||
```
|
||||
|
||||
在 Windows 上，运行`.\main.exe`而不是`./main`。不管使用何种系统，你应该在终端看到`Hello, world!`字符串。如果你做到了，那么恭喜你！你已经正式编写了一个 Rust 程序，成为一名 Rust 程序员了！欢迎入坑。
|
||||
在 Windows 上，运行 `.\main.exe`，而不是`./main`。不管使用何种系统，你应该在终端看到 `Hello, world!` 字样。如果你做到了，恭喜你！你已经正式编写了一个 Rust 程序，成为一名 Rust 程序员！
|
||||
|
||||
### 分析 Rust 程序
|
||||
|
||||
现在，让我们回过头来，仔细看看“Hello, world!”程序到底发生了什么。这里是谜题的第一片：
|
||||
现在，让我们回过头来，仔细看看“Hello, world!”程序到底发生了什么。这是拼图的第一片：
|
||||
|
||||
```rust
|
||||
fn main() {
|
||||
@ -64,35 +64,35 @@ fn main() {
|
||||
}
|
||||
```
|
||||
|
||||
这几行定义了一个 Rust **函数**。`main`函数是特殊的：这是每一个可执行的 Rust 程序的入口点。第一行表示“定义一个叫 `main` 的函数，没有参数也没有返回值。”如果有参数的话，它们应该出现在括号中，`(`和`)`之间。
|
||||
这几行定义了一个 Rust **函数**。一个叫 `main` 的函数，没有参数也没有返回值。如果有参数的话，它们应该出现在括弧中，`(`和`)`之间。`main` 函数是特殊的：它是每一个可执行的 Rust 程序的入口点。
|
||||
|
||||
同时注意函数体被包裹在大括号中，`{`和`}` 之间。Rust 要求所有函数体都位于大括号中（译者注：有些语言函数体只有一行时可以省略大括号，但 Rust 中是不行的）。一般来说，将左大括号与函数声明置于一行，并以空格分隔，是良好的代码风格。
|
||||
还须注意函数体被包裹在花括号中，`{`和`}` 之间。所有函数体都要用花括号包裹起来（译者注：有些语言，当函数体只有一行时可以省略花括号，但 Rust 中是不行的）。一般来说，将左花括号与函数声明置于一行，并以空格分隔，是良好的代码风格。
|
||||
|
||||
在`main()`函数中：
|
||||
在 `main()` 函数中：
|
||||
|
||||
```rust
|
||||
println!("Hello, world!");
|
||||
```
|
||||
|
||||
这行代码做了这个小程序的所有工作：它在屏幕上打印文本。这里有很多需要注意的细节。第一个是 Rust 代码风格使用 4 个空格缩进，而不是 1 个制表符（tab）。
|
||||
一行代码完成这个小程序的所有工作：在屏幕上打印文本。这里有很多细节需要注意。首先 Rust 使用 4 个空格的缩进风格，而不是 1 个制表符（tab）。
|
||||
|
||||
第二个重要的部分是`println!()`。这是 Rust **宏**，进行 Rust 元编程（metaprogramming）的关键所在。而调用一个函数的话，则要像这样：`println`（没有`!`）。我们将在 21 章 E 小节中更加详细的讨论 Rust 宏，不过现在你只需记住，当看到符号`!`的时候，就表示调用宏而不是普通函数。
|
||||
第二个重要的部分是`println!()`。这是 **宏**，Rust 元编程（metaprogramming）的关键所在。而调用一个函数，则要像这样：`println`（没有`!`）。我们将在 21 章 E 小节中更加详细的讨论宏，现在你只需记住，当看到符号 `!` 的时候，调用的是宏而不是普通函数。
|
||||
|
||||
接下来，`"Hello, world!"` 是一个 **字符串**。我们把这个字符串作为一个参数传递给`println!`，它负责在屏幕上打印这个字符串。轻松加愉快！(⊙o⊙)
|
||||
|
||||
该行以分号结尾（`;`）。`;`代表一个表达式的结束和下一个表达式的开始。大部分 Rust 代码行以`;`结尾。
|
||||
该行以分号结尾（`;`）。`;` 代表一个表达式的结束和下一个表达式的开始。大部分 Rust 代码行以 `;` 结尾。
|
||||
|
||||
### 编译和运行是两个步骤
|
||||
|
||||
在“编写并运行 Rust 程序”部分，展示了如何运行一个新创建的程序。现在我们将拆分并检查每一步操作。
|
||||
|
||||
在运行一个 Rust 程序之前，必须先编译它。可以输入`rustc`命令来使用 Rust 编译器，并传递源文件的名字给它，如下：
|
||||
运行一个 Rust 程序之前，必须先编译它。可以通过 `rustc` 命令来使用 Rust 编译器，并传递源文件的名字给它，如下：
|
||||
|
||||
```
|
||||
$ rustc main.rs
|
||||
```
|
||||
|
||||
如果你有 C 或 C++ 背景，就会发现这与`gcc`和`clang`类似。编译成功后，Rust 应该会输出一个二进制可执行文件，在 Linux 或 OSX 上在 shell 中你可以通过`ls`命令看到如下：
|
||||
如果你有 C 或 C++ 背景，就会发现这与 `gcc` 和 `clang` 类似。编译成功后，Rust 应该会输出一个二进制可执行文件，在 Linux 或 OSX 上在 shell 中你可以通过`ls`命令看到如下：
|
||||
|
||||
```
|
||||
$ ls
|
||||
@ -107,7 +107,7 @@ main.exe
|
||||
main.rs
|
||||
```
|
||||
|
||||
这表示我们有两个文件：*.rs* 后缀的源文件，和可执行文件（在 Windows下是 *main.exe*，其它平台是 *main*）。现在需要做的就只有运行 *main* 或 *main.exe* 文件了，像这样：
|
||||
这表示我们有两个文件：*.rs* 后缀的源文件，和可执行文件（在 Windows下是 *main.exe*，其它平台是 *main*）。然后运行 *main* 或 *main.exe* 文件，像这样：
|
||||
|
||||
```
|
||||
$ ./main # or .\main.exe on Windows
|
||||
@ -115,27 +115,27 @@ $ ./main # or .\main.exe on Windows
|
||||
|
||||
如果 *main.rs* 是我们的“Hello, world!”程序，它将会在终端上打印`Hello, world!`。
|
||||
|
||||
来自 Ruby、Python 或 JavaScript 这样的动态类型语言背景的同学，可能不太习惯将编译和执行分为两个步骤。Rust 是一种 **预编译静态类型语言**（*ahead-of-time compiled language*），这意味着编译好程序后，把它给任何人，他们不需要安装 Rust 就可运行。如果你给他们一个 `.rb` ， `.py` 或 `.js` 文件，他们需要先分别安装 Ruby，Python，JavaScript 实现（运行时环境，VM），不过你只需要一句命令就可以编译和执行程序。这一切都是语言设计的权衡取舍。
|
||||
来自 Ruby、Python 或 JavaScript 这样的动态类型语言背景的同学，可能不太习惯将编译和执行分为两个步骤。Rust 是一种 **预编译静态类型语言**（*ahead-of-time compiled language*），这意味着编译好程序后，把它给任何人，他们不需要安装 Rust 就可运行。如果你给他们一个 `.rb` ， `.py` 或 `.js` 文件，他们需要先分别安装 Ruby，Python，JavaScript 实现（运行时环境，VM），不过你只需要一句命令就可以编译和执行程序。这一切都是语言设计上的权衡取舍。
|
||||
|
||||
使用 `rustc` 编译简单程序是没问题的，不过随着项目的增长，你将想要能够控制你项目的方方面面，并使其易于分享你的代码给别人或别的项目。接下来，我们将介绍一个叫做 Cargo 的工具，它将帮助你编写真实世界中的 Rust 程序。
|
||||
|
||||
## Hello, Cargo!
|
||||
|
||||
Cargo 是 Rust 的构建系统和包管理工具，同时 Rustacean 们使用 Cargo 来管理他们的 Rust 项目，因为它使得很多任务变得更轻松。例如，Cargo 负责构建代码、下载代码依赖的库并编译这些库。我们把代码需要的库叫做 **依赖**（*dependencies*）。
|
||||
Cargo 是 Rust 的构建系统和包管理工具，同时 Rustacean 们使用 Cargo 来管理他们的 Rust 项目，它使得很多任务变得更轻松。例如，Cargo 负责构建代码、下载依赖库并编译。我们把代码需要的库叫做 **依赖**（*dependencies*）。
|
||||
|
||||
最简单的 Rust 程序，例如我们刚刚编写的，并没有任何依赖，所以目前我们只使用了 Cargo 负责构建代码的那一部分。随着编写更加复杂的 Rust 程序，你会想要添加依赖，如果你使用 Cargo 开始的话，这将会变得简单许多。
|
||||
最简单的 Rust 程序，比如我们刚刚编写的，并没有任何依赖，所以我们只使用了 Cargo 构建代码的功能。随着更复杂程序的编写，你会想要添加依赖，如果你使用 Cargo 开始的话，这将会变得简单许多。
|
||||
|
||||
由于绝大部分 Rust 项目使用 Cargo，本书接下来的部分将假设你使用它。如果使用安装章节介绍的官方安装包的话，Rust 自带 Cargo。如果通过其他方式安装 Rust 的话，可以在终端输入如下命令检查是否安装了 Cargo：
|
||||
由于绝大部分 Rust 项目使用 Cargo，本书接下来的部分将假设你使用它。如果使用之前介绍的官方安装包的话，它自带 Cargo。如果通过其他方式安装的话，可以在终端输入如下命令，检查是否安装了 Cargo：
|
||||
|
||||
```
|
||||
$ cargo --version
|
||||
```
|
||||
|
||||
如果出现了版本号，一切 OK！如果出现一个类似“`command not found`”的错误，那么你应该查看安装方式的文档来确定如何单独安装 Cargo。
|
||||
如果出现了版本号，一切 OK！如果出现类似“`command not found`”的错误，你应该查看安装文档以确定如何单独安装 Cargo。
|
||||
|
||||
### 使用 Cargo 创建项目
|
||||
|
||||
让我们使用 Cargo 来创建一个新项目并看看与上面的`hello_world`项目有什么不同。回到 projects 目录（或者任何你决定放置代码的目录）：
|
||||
让我们使用 Cargo 来创建一个新项目，然后看看与上面的`hello_world`项目有什么不同。回到 projects 目录（或者任何你放置代码的目录）：
|
||||
|
||||
Linux 和 Mac:
|
||||
|
||||
@ -156,11 +156,11 @@ $ cargo new hello_cargo --bin
|
||||
$ cd hello_cargo
|
||||
```
|
||||
|
||||
我们向`cargo new`传递了`--bin`因为我们的目标是生成一个可执行程序，而不是一个库。可执行文件是二进制可执行文件，通常就叫做 **二进制文件**（*binaries*）。项目的名称被定为`hello_cargo`，同时 Cargo 在一个同名目录中创建它的文件，接着我们可以进入查看。
|
||||
我们向 `cargo new` 传递了 `--bin`，因为我们的目标是生成一个可执行程序，而不是一个库。可执行程序是二进制可执行文件，通常就叫做 **二进制文件**（*binaries*）。项目的名称被定为`hello_cargo`，同时 Cargo 在一个同名目录中创建它的文件，接着我们可以进入查看。
|
||||
|
||||
如果列出 *hello_cargo* 目录中的文件，将会看到 Cargo 生成了一个文件和一个目录：一个 *Cargo.toml* 文件和一个 *src* 目录，*main.rs* 文件位于目录中。它也在 *hello_cargo* 目录初始化了一个 git 仓库，以及一个 *.gitignore* 文件；你可以改为使用不同的版本控制系统（VCS），或者不使用 VCS，通过`--vcs`参数。
|
||||
如果列出 *hello_cargo* 目录中的文件，将会看到 Cargo 生成了一个文件和一个目录：一个 *Cargo.toml* 文件和一个 *src* 目录，*main.rs* 文件位于目录中。它也在 *hello_cargo* 目录初始化了一个 git 仓库，以及一个 *.gitignore* 文件；你可以通过`--vcs`参数，切换到其它版本控制系统（VCS），或者不使用 VCS。
|
||||
|
||||
使用你选择的文本编辑器（IDE）打开 *Cargo.toml* 文件。它应该看起来像这样：
|
||||
使用文本编辑器（IDE）打开 *Cargo.toml* 文件。它应该看起来像这样：
|
||||
|
||||
<span class="filename">Filename: Cargo.toml</span>
|
||||
|
||||
@ -173,13 +173,13 @@ authors = ["Your Name <you@example.com>"]
|
||||
[dependencies]
|
||||
```
|
||||
|
||||
这个文件使用[*TOML*][toml]<!-- ignore --> (Tom's Obvious, Minimal Language) 格式。TOML 类似于 INI，不过有一些额外的改进之处，并且被用作 Cargo 的配置文件的格式。
|
||||
这个文件使用 [*TOML*][toml]<!-- ignore --> (Tom's Obvious, Minimal Language) 格式。TOML 类似于 INI，不过有一些额外的改进之处，并且被用作 Cargo 的配置文件的格式。
|
||||
|
||||
[toml]: https://github.com/toml-lang/toml
|
||||
|
||||
第一行，`[package]`，是一个部分标题表明下面的语句用来配置一个包。随着我们在这个文件增加更多的信息，还将增加其他部分。
|
||||
第一行，`[package]`，是一个段落标题，表明下面的语句用来配置一个包。随着我们在这个文件增加更多的信息，还将增加其他段落。
|
||||
|
||||
最后一行，`[dependencies]`，是列出项目依赖的 *crates*（我们这么称呼 Rust 代码包）的部分的开始，这样 Cargo 也就知道去下载和编译它们了。这个项目并不需要任何其他的 crate，不过在下一章猜猜看教程会需要。
|
||||
最后一行，`[dependencies]`，是项目依赖的 *crates*（Rust 代码包）的段落的开始，这样 Cargo 就知道下载和编译它们了。这个项目并不需要任何其他的 crate，不过在下一章猜猜看教程会需要。
|
||||
|
||||
现在看看 *src/main.rs*：
|
||||
|
||||
@ -191,14 +191,14 @@ fn main() {
|
||||
}
|
||||
```
|
||||
|
||||
Cargo 为你生成了一个“Hello World!”，正如我们之前编写的那个！目前为止我们所见过的之前项目与 Cargo 生成的项目区别有：
|
||||
Cargo 为你生成了一个“Hello World!”，正如我们之前编写的那个！目前为止，之前项目与 Cargo 生成项目区别有：
|
||||
|
||||
- 代码位于 *src* 目录
|
||||
- 项目根目录包含一个 *Cargo.toml* 配置文件
|
||||
|
||||
Cargo 期望源文件位于 *src* 目录，这样将项目根目录留给 README、license 信息、配置文件和其他跟代码无关的文件。这样，Cargo 帮助你保持项目干净整洁。一切井井有条。
|
||||
Cargo 期望源文件位于 *src* 目录，将项目根目录留给 README、license 信息、配置文件和其他跟代码无关的文件。这样，Cargo 帮助你保持项目干净整洁，一切井井有条。
|
||||
|
||||
如果没有使用 Cargo 开始项目，正如在 *hello_world* 目录中的项目，可以把它转化为一个使用 Cargo 的项目，通过将代码放入 *src* 目录并创建一个合适的 *Cargo.toml*。
|
||||
如果没有用 Cargo 创建项目，比如 *hello_world* 目录中的项目，可以通过将代码放入 *src* 目录，并创建一个合适的 *Cargo.toml*，将其转化为一个 Cargo 项目。
|
||||
|
||||
### 构建并运行 Cargo 项目
|
||||
|
||||
@ -218,7 +218,7 @@ Hello, world!
|
||||
|
||||
好的！如果一切顺利，`Hello, world!`应该再次打印在终端上。
|
||||
|
||||
第一次运行`cargo build`的时候也会使 Cargo 在项目根目录创建一个叫做 *Cargo.lock* 的新文件，它看起来像这样：
|
||||
首次运行 `cargo build` 的时候，Cargo 会在项目根目录创建一个新文件，*Cargo.lock*，它看起来像这样：
|
||||
|
||||
<span class="filename">Filename: Cargo.lock</span>
|
||||
|
||||
@ -228,9 +228,9 @@ name = "hello_cargo"
|
||||
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
|
||||
@ -238,7 +238,7 @@ $ cargo run
|
||||
Hello, world!
|
||||
```
|
||||
|
||||
注意这一次，并没有出现告诉我们 Cargo 正在编译 `hello_cargo` 的输出。Cargo 发现文件并没有被改变，所以只是运行了二进制文件。如果修改了源文件的话，将会出现像这样的输出：
|
||||
注意这一次，并没有出现告诉我们 Cargo 正在编译 `hello_cargo` 的输出。Cargo 发现文件并没有被改变，直接运行了二进制文件。如果修改了源文件的话，将会出现像这样的输出：
|
||||
|
||||
```
|
||||
$ cargo run
|
||||
@ -247,12 +247,12 @@ $ cargo run
|
||||
Hello, world!
|
||||
```
|
||||
|
||||
所以现在又出现一些更多的不同：
|
||||
所以现在又出现更多的不同：
|
||||
|
||||
- 使用`cargo build`构建项目（或使用`cargo run`一步构建并运行），而不是使用`rustc`
|
||||
- 不同于将构建结果放在源码相同目录，Cargo 会将它放到 *target/debug* 目录中的文件。
|
||||
- 使用 `cargo build` 构建项目（或使用 `cargo run` 一步构建并运行），而不是使用`rustc`
|
||||
- 有别于将构建结果放在源码目录，Cargo 将它放到 *target/debug* 目录。
|
||||
|
||||
Cargo 的另一个优点是不管你使用什么操作系统它的命令都是一样的，所以之后我们将不再为 Linux 和 Mac 以及 Windows 提供特定的命令。
|
||||
Cargo 的另一个优点是，不管你使用什么操作系统，它的命令都是一样的，所以之后我们将不再为 Linux 和 Mac 以及 Windows 提供相应的命令。
|
||||
|
||||
### 发布构建
|
||||
|
||||
@ -260,7 +260,7 @@ Cargo 的另一个优点是不管你使用什么操作系统它的命令都是
|
||||
|
||||
### 把 Cargo 当作习惯
|
||||
|
||||
对于简单项目， Cargo 并不能比`rustc`提供更多的价值，不过随着开发的进行终将体现它的价值。对于拥有多个 crate 的复杂项目，让 Cargo 来协调构建将更简单。有了 Cargo，只需运行`cargo build`，然后一切将有序运行。即便这个项目很简单，现在也它使用了很多之后你的 Rust 程序生涯将会用得上的实用工具。事实上，无形中你可以使用下面的命令开始所有你想要从事的项目：
|
||||
对于简单项目， Cargo 并不能比`rustc`提供更多的价值，不过随着开发的进行终将体现它的价值。对于拥有多个 crate 的复杂项目，让 Cargo 来协调构建将更简单。有了 Cargo，只需运行`cargo build`，然后一切将有序运行。即便这个项目很简单，也它使用了很多你之后的 Rust 生涯将会用得上的实用工具。其实你可以开始任何你想要从事的项目，使用下面的命令：
|
||||
|
||||
```
|
||||
$ git clone someurl.com/someproject
|
||||
@ -268,6 +268,6 @@ $ cd someproject
|
||||
$ cargo build
|
||||
```
|
||||
|
||||
> 注意：如果你想要查看 Cargo 的更多细节，请阅读官方的 [Cargo guide]，它覆盖了其所有的功能。
|
||||
> 注意：如果想要了解 Cargo 更多的细节，请阅读官方的 [Cargo guide]，它覆盖了所有的功能。
|
||||
|
||||
[Cargo guide]: http://doc.crates.io/guide.html
|
||||
|
||||
Loading…
Reference in New Issue
Block a user