Update ch01

src/ch01-00-getting-started.md

@@ -1,6 +1,6 @@
 # 入门指南
 
-让我们开始 Rust 之旅！有很多内容需要学习，但每次旅程总有起点。在本章中，我们会讨论：
+让我们开始 Rust 之旅吧！有很多内容需要学习，但每次旅程总有起点。在本章中，我们会讨论：
 
 * 在 Linux、macOS 和 Windows 上安装 Rust
 * 编写一个打印 `Hello, world!` 的程序

src/ch01-01-installation.md

@@ -2,7 +2,7 @@
 
 第一步是安装 Rust。我们将通过 `rustup` 来下载 Rust，这是一个管理 Rust 版本和相关工具的命令行工具。这需要互联网连接才能下载。
 
-> 注意：如果你出于某些原因不想用 `rustup`，请参阅 请参阅 [Rust 其他安装方法的页面][otherinstall] 了解更多选项。
+> 注意：如果你出于某些原因不想用 `rustup`，请参阅 请参阅 [Rust 其他安装方法的页面][otherinstall]<!-- ignore -->了解更多选项。
 
 [otherinstall]: https://forge.rust-lang.org/infra/other-installation-methods.html
 
@@ -40,7 +40,7 @@ Linux 用户一般应按照相应发行版的文档来安装 GCC 或 Clang。例
 
 ### 在 Windows 上安装 `rustup`
 
-在 Windows 上，访问 [https://www.rust-lang.org/zh-CN/tools/install][install] 页面并按照说明安装 Rust。在安装过程的某个步骤，你可能会收到一条消息，提示你还需要适用于 Visual Studio 2013 或更高版本的 C++ 的构建工具（C++ build tools）。获取这些构建工具的最简单方法是安装 [Visual Studio 2019 的构建工具][visualstudio]。当被问及要安装哪些内容时，请确保已选择 “C++ build tools”，并包括 Windows 10 SDK 和英文语言包。
+在 Windows 上，访问 [https://www.rust-lang.org/zh-CN/tools/install][install]<!-- ignore --> 页面并按照说明安装 Rust。在安装过程的某个步骤，你可能会收到一条消息，提示你还需要适用于 Visual Studio 2013 或更高版本的 C++ 的构建工具（C++ build tools）。获取这些构建工具的最简单方法是安装 [Visual Studio 2019 的构建工具][visualstudio]<!-- ignore -->。当被问及要安装哪些内容时，请确保已选择 “C++ build tools”，并包括 Windows 10 SDK 和英文语言包。
 
 [install]: https://www.rust-lang.org/zh-CN/tools/install
 [visualstudio]: https://visualstudio.microsoft.com/visual-cpp-build-tools/
@@ -75,7 +75,7 @@ $ rustc --version
 rustc x.y.z (abcabcabc yyyy-mm-dd)
 ```
 
-如果你看到此信息，则说明您已成功安装 Rust！如果没看到此信息，并且你使用的是 Windows，请检查 Rust 是否在 `%PATH%` 系统变量中。如果都正确，但 `Rust` 仍然无法正常工作，那么你可以在很多地方获得帮助。最简单的是去 [Rust 官方 Discord][discord] 的 #beginners 频道 。在这里，你可以和其他 Rustacean（Rust 用户，自嘲的昵称）聊天并寻求帮助。其他不错的资源还有 [Rust 用户论坛][users] 和 [Stack Overflow][stackoverflow]。
+如果你看到此信息，则说明您已成功安装 Rust！如果没看到此信息，并且你使用的是 Windows，请检查 Rust 是否在 `%PATH%` 系统变量中。如果都正确，但 `Rust` 仍然无法正常工作，那么你可以在很多地方获得帮助。最简单的是去 [Rust 官方 Discord][discord]<!-- ignore --> 的 #beginners 频道 。在这里，你可以和其他 Rustacean（Rust 用户，自嘲的昵称）聊天并寻求帮助。其他不错的资源还有 [Rust 用户论坛][users]<!-- ignore -->和 [Stack Overflow][stackoverflow]。
 
 [discord]: https://discord.gg/rust-lang
 [users]: https://users.rust-lang.org/

src/ch01-02-hello-world.md

@@ -60,7 +60,7 @@ Hello, world!
 Hello, world!
 ```
 
-不管你使用哪种操作系统，该字符串 `Hello, world!` 都应打印到了终端上。如果看不到此输出，请参考“安装”小节的 [“疑难解答”][troubleshooting]<!-- ignore --> 小节来查找解决方法。
+不管你使用哪种操作系统，该字符串 `Hello, world!` 都应打印到了终端上。如果看不到此输出，请参考“安装”小节的[“疑难解答”][troubleshooting]<!-- ignore -->小节来查找解决方法。
 
 如果 `Hello, world!` 打印成功，那么祝贺你！你已经正式编写了一个 Rust 程序。你已经成为了一名 Rust 开发者——欢迎加入 Rust 大家庭！
 

src/ch01-03-hello-cargo.md

@@ -1,16 +1,16 @@
 ## Hello, Cargo!
 
-Cargo 是 Rust 的构建系统和包管理器。大多数 Rustacean 们使用 Cargo 来管理他们的 Rust 项目，因为它可以为你处理很多任务，比如构建代码、下载依赖库，以及编译这些库。（我们把代码所需要的库叫做**依赖**（*dependencies*））。
+Cargo 是 Rust 的构建系统和包管理器。大多数 Rustacean 们使用 Cargo 来管理他们的 Rust 项目，因为它可以为你处理很多任务，比如构建代码、下载依赖库，以及编译这些库。（我们把代码所需要的库叫做**依赖**（*dependency*））。
 
 最简单的 Rust 程序（如我们刚刚编写的）不含任何依赖。所以如果使用 Cargo 来构建 “Hello, world!” 项目，将只会用到 Cargo 构建代码的那部分功能。在编写更复杂的 Rust 程序时，你将添加依赖项，如果使用 Cargo 启动项目，则添加依赖项将更容易。
 
-由于绝大多数 Rust 项目使用 Cargo，本书接下来的部分假设你也使用 Cargo。如果使用 [“安装”][installation]<!-- ignore --> 部分介绍的官方安装包的话，则自带了 Cargo。如果通过其他方式安装的话，可以在终端输入如下命令检查是否安装了 Cargo：
+由于绝大多数 Rust 项目使用 Cargo，本书接下来的部分假设你也使用 Cargo。如果使用[“安装”][installation]<!-- ignore --> 部分介绍的官方安装包的话，则自带了 Cargo。如果通过其他方式安装的话，可以在终端输入如下命令检查是否安装了 Cargo：
 
 ```console
 $ cargo --version
 ```
 
-如果你看到了版本号，说明已安装！如果看到类似 `command not found` 的错误，你应该查看相应安装文档以确定如何单独安装 Cargo。
+如果你看到了版本号，说明安装成功！如果看到类似 `command not found` 的错误，你应该查看相应安装文档以确定如何单独安装 Cargo。
 
 ### 使用 Cargo 创建项目
 
@@ -37,7 +37,7 @@ $ cd hello_cargo
 [package]
 name = "hello_cargo"
 version = "0.1.0"
-edition = "2018"
+edition = "2021"
 
 [dependencies]
 ```
@@ -48,7 +48,7 @@ edition = "2018"
 
 第一行，`[package]`，是一个表块（section）标题，表明下面的语句用来配置一个包（package）。随着我们在这个文件增加更多的信息，还将增加其他表块。
 
-接下来的三行设置了 Cargo 编译程序所需的配置：项目的名称、版本，以及使用的 Rust 大版本号（edition，区别于 version）。附录 E 会介绍 `edition`（译注：Rust 的核心版本，即 2015、2018、2021 版等） 的值。
+接下来的三行设置了 Cargo 编译程序所需的配置：项目的名称、版本，以及使用的 Rust 大版本号（edition，区别于 version）。[附录 E][appendix-e]<!-- ignore --> 会介绍 `edition`（译注：Rust 的核心版本，即 2015、2018、2021 版等） 的值。
 
 最后一行的 `[dependencies]` 是罗列项目依赖的表块的开始。在 Rust 中，代码包被称为 *crate*。这个项目并不需要其他的 crate，不过在第 2 章的第一个项目会用到依赖，那时会用得上这个表块。
 
@@ -106,7 +106,7 @@ $ cargo run
 Hello, world!
 ```
 
-Cargo 还提供了一个叫 `cargo check` 的命令。该命令快速检查代码确保其可以编译，但并不产生可执行文件：
+Cargo 还提供了一个名为 `cargo check` 的命令。该命令快速检查代码确保其可以编译，但并不产生可执行文件：
 
 ```console
 $ cargo check
@@ -141,7 +141,7 @@ $ cd someproject
 $ cargo build
 ```
 
-关于更多 Cargo 的信息，请查阅[对应文档][its documentation]。
+关于更多 Cargo 的信息，请查阅[相应文档][its documentation]<!-- ignore -->。
 
 [its documentation]: https://rustwiki.org/zh-CN/cargo/
 
@@ -158,3 +158,4 @@ $ cargo build
 是时候通过构建更具强大的程序来熟悉阅读和编写 Rust 代码了。所以在第 2 章我们会构建一个猜数字游戏程序。如果你更愿意从学习 Rust 常用的编程概念开始，请阅读第 3 章，接着再回到第 2 章。
 
 [installation]: ch01-01-installation.html#安装
+[appendix-e]: appendix-05-editions.html