Update ch01

This commit is contained in:
Aaran Xu 2022-01-30 01:38:36 +08:00
parent 12d83ba094
commit fbba3c3cd8
4 changed files with 13 additions and 12 deletions

View File

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

View File

@ -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 频道 。在这里,你可以和其他 RustaceanRust 用户,自嘲的昵称)聊天并寻求帮助。其他不错的资源还有 [Rust 用户论坛][users] 和 [Stack Overflow][stackoverflow]。
如果你看到此信息,则说明您已成功安装 Rust如果没看到此信息并且你使用的是 Windows请检查 Rust 是否在 `%PATH%` 系统变量中。如果都正确,但 `Rust` 仍然无法正常工作,那么你可以在很多地方获得帮助。最简单的是去 [Rust 官方 Discord][discord]<!-- ignore -->#beginners 频道 。在这里,你可以和其他 RustaceanRust 用户,自嘲的昵称)聊天并寻求帮助。其他不错的资源还有 [Rust 用户论坛][users]<!-- ignore -->和 [Stack Overflow][stackoverflow]。
[discord]: https://discord.gg/rust-lang
[users]: https://users.rust-lang.org/

View File

@ -1,6 +1,6 @@
## Hello, Cargo!
Cargo 是 Rust 的构建系统和包管理器。大多数 Rustacean 们使用 Cargo 来管理他们的 Rust 项目,因为它可以为你处理很多任务,比如构建代码、下载依赖库,以及编译这些库。(我们把代码所需要的库叫做**依赖***dependencies*))。
Cargo 是 Rust 的构建系统和包管理器。大多数 Rustacean 们使用 Cargo 来管理他们的 Rust 项目,因为它可以为你处理很多任务,比如构建代码、下载依赖库,以及编译这些库。(我们把代码所需要的库叫做**依赖***dependency*))。
最简单的 Rust 程序(如我们刚刚编写的)不含任何依赖。所以如果使用 Cargo 来构建 “Hello, world!” 项目,将只会用到 Cargo 构建代码的那部分功能。在编写更复杂的 Rust 程序时,你将添加依赖项,如果使用 Cargo 启动项目,则添加依赖项将更容易。
@ -10,7 +10,7 @@ Cargo 是 Rust 的构建系统和包管理器。大多数 Rustacean 们使用 Ca
$ 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