From bcf39f0767b2fc2fd1403087f5cf7ee21ee563e0 Mon Sep 17 00:00:00 2001 From: tomoat Date: Thu, 27 Jan 2022 17:01:19 +0800 Subject: [PATCH 1/7] Update cargo.md --- book/contents/first-try/cargo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/contents/first-try/cargo.md b/book/contents/first-try/cargo.md index 83d674f7..7653b333 100644 --- a/book/contents/first-try/cargo.md +++ b/book/contents/first-try/cargo.md @@ -13,7 +13,7 @@ 又见"你好,世界"，肯定有读者在批评了：你就不能有点创意吗？"世界,你好"难道不配？你是读者，你说了算，那我们就来创建一个"世界，你好"。 -上文提到，Rust 语言的包管理工具是 `cargo`，好在，我们无需手动安装，在之前安装Rust的时候，就一并安装，如果你在终端无法使用这个命令，考虑一下 `环境变量` 是否正确的设置：把 `cargo` 可执行文件所在的目录添加到环境变量中。 +上文提到，Rust 语言的包管理工具是 `cargo`，好在，在之前安装Rust的时候，就一并安装了 `cargo`，如果你在终端无法使用这个命令，检查一下 `环境变量` 是否正确的设置：把 `cargo` 可执行文件所在的目录添加到环境变量中。 终于到了紧张刺激的 new new new 环节: ```console From 452ddd04584d9f3c7d8526b0360ff83b50443346 Mon Sep 17 00:00:00 2001 From: tomoat Date: Thu, 27 Jan 2022 17:19:48 +0800 Subject: [PATCH 2/7] Update cargo.md --- book/contents/first-try/cargo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/contents/first-try/cargo.md b/book/contents/first-try/cargo.md index 7653b333..91c2b4f5 100644 --- a/book/contents/first-try/cargo.md +++ b/book/contents/first-try/cargo.md @@ -73,7 +73,7 @@ $ ./target/debug/world_hello Hello, world! ``` -行云流水，但谈不上一气呵成。 细心的读者可能已经发现，在调用的时候，路径 `./target/debug/world_hello` 中有一个明晃晃的 `debug` 字段，没错我们运行的是 `debug` 模式，在这种模式下，**代码的编译速度会非常快**，可是福兮祸所依，**运行速度就慢了**. 原因是，在 `debug` 模式下，Rust 编译器不会做任何的优化，只为了尽快的编译完成，让你的开发流程更加顺畅。 +行云流水，但谈不上一气呵成。 细心的读者可能已经发现，在调用的时候，调用的是路径 `./target/debug/` 下的 `world_hello`，没错我们运行的是 `debug` 模式，在这种模式下，**代码的编译速度会非常快**，可是福兮祸所依，**运行速度就慢了**. 原因是，在 `debug` 模式下，Rust 编译器不会做任何的优化，只为了尽快的编译完成，让你的开发流程更加顺畅。 作为尊贵的读者，咱自然可以要求更多，比如你想要高性能的代码怎么办？ 简单，添加 `--release` 来编译： - `cargo run --release` From 34336d72f9780d5ea4d78fa4b7357cbf4408dc58 Mon Sep 17 00:00:00 2001 From: tomoat Date: Thu, 27 Jan 2022 17:52:12 +0800 Subject: [PATCH 3/7] Update cargo.md --- book/contents/first-try/cargo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/contents/first-try/cargo.md b/book/contents/first-try/cargo.md index 91c2b4f5..0c248798 100644 --- a/book/contents/first-try/cargo.md +++ b/book/contents/first-try/cargo.md @@ -97,7 +97,7 @@ $ cargo check Finished dev [unoptimized + debuginfo] target(s) in 0.06s ``` -> Rust 虽然编译速度还行，但是还是不能 Go 语言相提并论，因为 Rust 需要做很多复杂的编译优化和语言特性解析, 甚至连如何优化编译速度都成了一门学问：[优化编译速度](../compiler/speed-up.md) +> Rust 虽然编译速度还行，但是还是不能和 Go 语言相提并论，因为 Rust 需要做很多复杂的编译优化和语言特性解析, 甚至连如何优化编译速度都成了一门学问：[优化编译速度](../compiler/speed-up.md) ## Cargo.toml 和 Cargo.lock From dbc1df54e9d4a5acbc1dc2073042151ce5c1756b Mon Sep 17 00:00:00 2001 From: tomoat Date: Fri, 28 Jan 2022 14:06:45 +0800 Subject: [PATCH 4/7] Update hello-world.md --- book/contents/first-try/hello-world.md | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/book/contents/first-try/hello-world.md b/book/contents/first-try/hello-world.md index 15162f98..ec207e5e 100644 --- a/book/contents/first-try/hello-world.md +++ b/book/contents/first-try/hello-world.md @@ -4,7 +4,7 @@ ## 多国语言的"世界，你好" -还记得大明湖畔等你的 [VSCode](./editor.md) IDE 和通过 `Cargo` 创建的[世界，你好](./cargo.md)工程嘛? +还记得大明湖畔等你的 [VSCode IDE](./editor.md) 和通过 `Cargo` 创建的[世界，你好](./cargo.md)工程吗? 现在使用 VSCode 打开[上一节](./cargo.md)中创建的 `world_hello` 工程, 然后进入 `main.rs` 文件，此文件是当前 Rust 工程的入口文件，和其它语言几无区别。 @@ -25,7 +25,7 @@ fn greet_world() { } ``` -打开终端，进入 `world_hello` 工程根目录，运行该程序(你也可以在 VSCode 中打开终端,方法是点击左下角的错误和警告图标)，你的热情，好像一把火，燃烧了整个世界： +打开终端，进入 `world_hello` 工程根目录，运行该程序(你也可以在 VSCode 中打开终端,方法是点击VSCode上方菜单栏中的终端->新建终端，或者直接使用快捷键打开)，你的热情，就像一把火，燃烧了整个世界： ```console $ cargo run Compiling world_hello v0.1.0 (/Users/sunfei/development/rust/world_hello) @@ -34,7 +34,6 @@ $ cargo run Grüß Gott! 世界，你好 World, hello -sunfei@sunfeideMa ``` 花点时间来看看上面的代码，首先，Rust 原生支持 UTF-8 编码的字符串，这意味着你可以很容易的使用世界各国文字作为字符串内容。 @@ -50,7 +49,7 @@ sunfei@sunfeideMa ## Rust语言初印象 Rust 这门语言对于 Haskell 和 Java 开发来说，会觉得很熟悉，因为它们在高阶表达方面都很优秀，简而言之，可以很简洁的写出原本需要一大堆代码才能表达的含义，但是 Rust 又有所不同：它的性能是底层语言级别的性能，可以跟 C/C++ 相媲美。 -上一句的 `So Easy` 的余音仍在绕梁，我希望它能继续下去，可是……人总是要面对现实，因此让我们来些狠的: +上面的 `So Easy` 的余音仍在绕梁，我希望它能继续下去，可是……人总是要面对现实，因此让我们来些狠的: ```rust fn main() { let penguin_data = "\ @@ -96,18 +95,18 @@ fn main() { ``` 看完这段代码，不知道你的余音有没有嘎然而止，反正我已经在颤抖了，这就是传说中的下马威嘛？上面代码中值得注意的 Rust 特性有： -- 控制流：`for` 和 `continue` 在一起，实现的循环 +- 控制流：`for` 和 `continue` 连在一起使用，实现循环控制 - 方法语法：由于 Rust 没有继承，因此 Rust 不是传统意义上的面向对象语言，但是它却从 `OO` 语言那里偷师了方法的使用 `record.trim()`，`record.split(',')` 等 -- 高阶函数编程：函数可以作为参数也能作为返回值，例如 `.map(|field| field.trim())`，这里 `map` 使用闭包函数作为参数，也可以称呼为 `匿名函数`、`lambda函数` +- 高阶函数编程：函数可以作为参数也能作为返回值，例如 `.map(|field| field.trim())`，这里 `map` 方法中使用闭包函数作为参数，也可以称呼为 `匿名函数`、`lambda函数` - 类型标注：`if let Ok(length) = fields[1].parse::()`, 通过 `::` 的使用，告诉编译器 `length` 是一个 `f32` 类型的浮点数，这种类型标注不是很常用，但是在编译器无法推断出你的数据类型时，就很有用了 -- 条件编译：`if cfg!(debug_assertions)`，说明紧跟其后的输出打印只在 `debug` 模式下生效 +- 条件编译：`if cfg!(debug_assertions)`，说明紧跟其后的输出（打印）只在 `debug` 模式下生效 - 隐式返回：Rust 提供了 `return` 关键字用于函数返回，但是在很多时候，我们可以省略它。因为 Rust 是[**基于表达式的语言**](../basic/base-type/statement-expression.md) -在终端运行上述代码时，会看到很多 `debug: ...` 的输出, 上面有讲，这些都是 `条件编译` 的输出, 那么该怎么消除掉这些输出呢？ +在终端中运行上述代码时，会看到很多 `debug: ...` 的输出, 上面有讲，这些都是 `条件编译` 的输出, 那么该怎么消除掉这些输出呢？ 读者大大普遍冰雪聪明，肯定已经想到：是的，在[认识Cargo](./cargo.md#手动编译和运行项目)中，曾经介绍过 `--release` 参数，因为 `cargo run` 默认是运行 `debug` 模式. 因此想要消灭那些 `debug:` 输出，需要更改为其它模式，其中最常用的模式就是 `--release` 也就是生产发布的模式。 具体运行代码就不给了，留给大家作为一个小练习，建议亲自动手尝试下。 -至此，Rust 安装入门就已经结束，相信看到这里，你已经发现了本书与其它书的区别，其中最大的区别就是：**这本书就像优秀的国外课本一样，不太枯燥，也希望这本不太枯燥的书，能伴你长行，犹如一杯奶茶，细细品之，唇齿余香**。 +至此，Rust 安装入门就已经结束，相信看到这里，你已经发现了本书与其它书的区别，其中最大的区别就是：**这本书就像优秀的国外课本一样，不太枯燥，也希望这本不太枯燥的书，能伴你长行，犹如一杯奶茶，细细品之，唇齿留香**。 From 23456e23c7db309b157e1a0cb50dceb1694eec06 Mon Sep 17 00:00:00 2001 From: tomoat Date: Fri, 28 Jan 2022 15:12:05 +0800 Subject: [PATCH 5/7] reduction part --- book/contents/first-try/cargo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/contents/first-try/cargo.md b/book/contents/first-try/cargo.md index 0c248798..987678f5 100644 --- a/book/contents/first-try/cargo.md +++ b/book/contents/first-try/cargo.md @@ -73,7 +73,7 @@ $ ./target/debug/world_hello Hello, world! ``` -行云流水，但谈不上一气呵成。 细心的读者可能已经发现，在调用的时候，调用的是路径 `./target/debug/` 下的 `world_hello`，没错我们运行的是 `debug` 模式，在这种模式下，**代码的编译速度会非常快**，可是福兮祸所依，**运行速度就慢了**. 原因是，在 `debug` 模式下，Rust 编译器不会做任何的优化，只为了尽快的编译完成，让你的开发流程更加顺畅。 +行云流水，但谈不上一气呵成。 细心的读者可能已经发现，在调用的时候，路径 `./target/debug/world_hello` 中有一个明晃晃的 `debug` 字段，没错我们运行的是 `debug` 模式，在这种模式下，**代码的编译速度会非常快**，可是福兮祸所依，**运行速度就慢了**. 原因是，在 `debug` 模式下，Rust 编译器不会做任何的优化，只为了尽快的编译完成，让你的开发流程更加顺畅。 作为尊贵的读者，咱自然可以要求更多，比如你想要高性能的代码怎么办？ 简单，添加 `--release` 来编译： - `cargo run --release` From 36a4a5e4628623abba14e8f04ca85023cf5593dd Mon Sep 17 00:00:00 2001 From: Colin Date: Fri, 28 Jan 2022 17:00:38 +0800 Subject: [PATCH 6/7] make the explanation more clear --- book/contents/basic/compound-type/string-slice.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/contents/basic/compound-type/string-slice.md b/book/contents/basic/compound-type/string-slice.md index 55666e33..fffe1d2e 100644 --- a/book/contents/basic/compound-type/string-slice.md +++ b/book/contents/basic/compound-type/string-slice.md @@ -119,7 +119,7 @@ error[E0502]: cannot borrow `s` as mutable because it is also borrowed as immuta | ---- immutable borrow later used here ``` -回忆一下借用的规则：当我们已经有了可变借用时，就无法再拥有不可变的借用。因为 `clear` 需要清空改变 `String`，因此它需要一个可变借用，而之后的 `println!` 又使用了不可变借用，因此编译无法通过。 +回忆一下借用的规则：当我们已经有了可变借用时，就无法再拥有不可变的借用。因为 `clear` 需要清空改变 `String`，因此它需要一个可变借用（利用 VSCode 可以看到该方法的声明是 `pub fn clear(&mut self)` ，参数是对自身的可变借用 ）；而之后的 `println!` 又使用了不可变借用，也就是在 `s.clear()` 处可变借用与不可变借用试图同时生效，因此编译无法通过。 从上述代码可以看出，Rust 不仅让我们的 `API` 更加容易使用，而且也在编译期就消除了大量错误！ From 9512ff7710895a209474a8277c88d1d0d4970b9c Mon Sep 17 00:00:00 2001 From: muwuren <32675834+muwuren@users.noreply.github.com> Date: Fri, 28 Jan 2022 17:08:00 +0800 Subject: [PATCH 7/7] =?UTF-8?q?"Async=20=E7=BC=96=E7=A8=8B=E7=AE=80?= =?UTF-8?q?=E4=BB=8B"=20=E8=A1=A8=E6=A0=BC=E5=88=86=E9=9A=94=E7=AC=A6?= =?UTF-8?q?=E9=94=99=E8=AF=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 修改表格分隔符为英文"|"，而不是中文"｜"。 --- book/contents/async/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/contents/async/getting-started.md b/book/contents/async/getting-started.md index b0daad22..19141ba9 100644 --- a/book/contents/async/getting-started.md +++ b/book/contents/async/getting-started.md @@ -61,7 +61,7 @@ | 操作 | async | 线程 | | ---- | ----- | ---- | | 创建 | 0.3微妙 | 17微妙 | -| 线程切换 ｜ 0.2微妙 | 1.7微妙 | +| 线程切换 | 0.2微妙 | 1.7微妙 | 可以看出，`async` 在线程切换的开销显著低于多线程，对于 IO 密集的场景，这种性能开销累计下来会非常可怕！