kaisery / trpl-zh-cn

Rust 程序设计语言（2021 edition）

Rust 程序设计语言（2021 edition）简体中文版

状态

施工完毕。

PS:

• 对照源码位置：https://github.com/rust-lang/book/tree/main/src
• 每章翻译开头都带有官方链接和 commit hash，若发现与官方不一致，欢迎 Issue 或 PR :)

静态页面构建与文档撰写

构建

你可以将本 mdbook 构建成一系列静态 html 页面。这里我们采用 mdbook 打包出静态网页。在这之前，你需要安装 Rust。

全局安装 mdbook

cargo install mdbook

cd 到项目目录，然后开始构建。构建好的静态文档会出现在 "./book/html" 中

mdbook build

文档撰写

可以通过任意的 http 服务器来预览构建的文档。举个例子：

cargo install simple-http-server
simple-http-server .\book\html\ -i

社区资源

• Rust 语言中文社区：https://rust.cc/
• Rust 中文 Wiki：https://wiki.rust-china.org/
• Rust 编程语言社区 1 群，群号：303838735（已满，只能内部邀请）
• Rust 编程语言社区 2 群，群号：813448660
• Rust 水群 (编程社区子群)，电报群：t.me/rust_deep_water

PDF

Rust 程序设计语言 简体中文版.pdf

• 由 mdbook-typst-pdf 生成，有任何问题欢迎 issue 或 PR

GitBook

本翻译主要采用 mdBook 格式。同时支持 GitBook，但会缺失部分功能，如一些代码没有语法高亮。

本翻译加速查看站点有：

• 深圳站点：http://120.78.128.153/rustbook

GitBook.com 地址：https://kaisery.github.io/trpl-zh-cn/

trpl-zh-cn's Issues

是否应该更新下README？

我觉得这个文档去年的时候就翻译的差不多了。
我觉得应该更新下各种说明了。这样也比较利于分享。

其他Rust官方文档的翻译

目前TRPL英文版基本上已经稳定下来，中文翻译应该也会很快稳定下来。 目前我认为最有用的文档并且没有中文翻译的包括

• Nomicon 解释Unsafe Rust
• Cookbook 一些基本的Rust程序
• Rust By Example 通过范例来解释Rust语言
• Reference Rust的参考资料

关于 trait

特征，特点，特性，使用时最顺口的就是 个性 性子，各种例子很好陈述， 配合的动词毫无疑问就是赋予

package registry site 应翻译为"包登记网站"

注册更像是账号登录一类的操作, 而"package registry site" 更像是在该网站上面进行登记, 声明已经有一个名字为name的crate包, 并不允许重名.

lifetime 的翻译讨论

”生命周期”一般指的是 lifecycle
把 lifetime 也翻译为生命周期是否有歧义？

17-02中Trait对象的对象安全规则翻译有误

关于对象安全的规则第一条，原文为
“The trait does not require Self to be Sized”
应译为
“该 trait 不能要求 Self 是 Sized”
而非现有译文中的
“该 trait 要求 Self 不是 Sized”
我看的时候纠结了半天。

另外，17-02还有不少地方很难懂，看了原文才知道是什么意思。建议改进一下。

错别字：服用 => 复用

https://kaisery.github.io/trpl-zh-cn/ch03-01-variables-and-mutability.html，

翻译错误

原文URL地址: https://doc.rust-lang.org/nightly/book/second-edition/ch02-00-guessing-game-tutorial.html#handling-invalid-input
原文内容: Switching from an expect call to a match expression is how you generally move from crash on error to actually handling the error.

翻译版URL地址: https://kaisery.github.io/trpl-zh-cn/ch02-00-guessing-game-tutorial.html
翻译内容: 从expect调用切换到expect语句是如何从遇到错误就崩溃到真正处理错误的常用手段。

应该翻译为: 从expect调用切换到match语句是如何从遇到错误就崩溃到真正处理错误的常用手段。

文字重复

https://kaisery.github.io/trpl-zh-cn/ch15-06-reference-cycles.html
#可视化-strong_count-和-weak_count-的改变

因为因为现在 leaf 又是 Rc 唯一的引用了。
--- 多了一个因为

FontAwesome 挂掉导致图标不显示

不清楚是什么时候开始， https://kaisery.github.io/trpl-zh-cn/ 这里的所有 font-awesome 图标都不显示了，导致页面上方导航按钮不显示，代码块右上角本来应该有的运行按钮不显示。 F12 可以看到浏览器请求了 https://kaisery.github.io/trpl-zh-cn/_FontAwesome/css/font-awesome.css 得到了 404 。

实在不是很熟悉 mdbook ，翻 repo 没找到可能相关的地方，对比 commit history 也没看出来是哪里出的问题...

代码片段丢失

https://kaisery.github.io/trpl-zh-cn/ch13-03-improving-our-io-project.html#使用迭代器并去掉clone

https://doc.rust-lang.org/book/second-edition/ch13-03-improving-our-io-project.html#removing-a-clone-using-an-iterator

main 方法中丢失代码片段

对于该项目中从clone修改为迭代后原先的语句已不能使用

顺便附上完整版：

fn main() {
    let mut stderr = std::io::stderr();

    let config = Config::new(env::args()).unwrap_or_else(|err| {
        writeln!(
            &mut stderr,
            "Problem parsing arguments: {}",
            err
        ).expect("Could not write to stderr");

        process::exit(1);
    });

    if let Err(e) = minigrep::run(config) {
        eprintln!("Application error: {}", e);

        process::exit(1);
    }
}

src/ch04-01-what-is-ownership.md错别字

src/ch04-01-what-is-ownership.md
“这个表现形式看起来 并不像 图 4-5 中的那样，它是如果 Rust 也拷贝了堆上的数据后内存看起来是怎么样的。”

它是 => 但是/那么

章节12.5中有一处错误

powershell设置环境变量应该是
$env:CASE_INSENSITIVE=1
但是文中是
$env.CASE_INSENSITIVE=1

“列表 10-20” 建议翻译为“码签 10-20”

文章里用来指代对应代码块的称呼，类似论文里“图 3-1”之类的。歪果仁说 "list 10-1"，"list"应该更类似于“便签条”，“收据单”的意思吧。“列表”这个称呼总让我出戏，其实本来打算建议“码单”来着，不过好像更出戏，额

重复

Link: https://kaisery.github.io/trpl-zh-cn/ch15-05-interior-mutability.html#refcellt拥有内部可变性

括号内应该为 Halting Problem

重复出现两次 停机问题

另外 Halting Problem 可以 link 一下 https://brilliant.org/wiki/halting-problem/

静态站点生成与本地加速

1.有没有意愿使用Vuepress将.md打包成静态html文件的计划？这样会很方便部署的。
2.github上的站点墙内访问挺慢的，所以我可以提供一个看这个文档的站点吗？（将打包的静态文件放到我的网站上）。

第十三章开始原文有改写？

校对翻译风格

平时对技术文档翻译根本不会有这种奢望，但感觉这项目整体质量不错，只是稍微有些欧化中文的影子。我和一位朋友有兴趣针对风格问题试着校对翻译，在开始之前来和项目维护者们打声招呼，确认下是否愿意接受此类修改。毕竟对风格的看法因人而异，修改后反而会和原文的字面意思有所偏差，如果维护者反对的话我们 fork 时也算有个心理预期。

拼写小错误

https://kaisery.github.io/trpl-zh-cn/ch10-03-lifetime-syntax.html#生命周期省略

下文中应该是 “换句话说” 而打成了 “话句话说”

typo ch09-02-recoverable-errors-with-result

第三行 写成前节的了

ch15-05-interior-mutability.md 中错别字: 连 => 两

RefCell<T> 和内部可变性模式

在此章节的以下内容中，存在错别字: 连 => 两

示例 15-26：在同一作用域中创建连个可变引用并观察 RefCell<T> panic

关于代码中的注释

代码中的很多注释都是原文的,是否考虑也翻译一下?

typo: 19.1节不安全的rust出现了错别字

这些typo由QQ群友 @谁杀了我的牛? 发现, 其提供的截图如下:

如图中描述, 红圈中的意外一词应为意味, 取笑一词应为取消

Mistake?

Slices

Where is capacity in world?

翻译歧义

https://kaisery.github.io/trpl-zh-cn/ch16-01-threads.html
#线程与-move-闭包

原文：If we were allowed to run this code, there’s a possibility the spawned thread would be immediately put in the background without running at all.
翻译：这段代码可以运行，而新建线程则可能会立刻被转移到后台并完全没有机会运行。

原文是假设这段代码能运行，翻译后为肯定能运行的意思，感觉不大合适。（实际代码是不能运行）
个人理解为：
假如这段代码能正常运行的话，就是可能这个线程被创建后立即移到后台并没有运行。

2018 edition 翻译

官方 repo https://github.com/rust-lang/book/tree/master/2018-edition 已经开坑了，是否考虑同步更新翻译？

英文版中不存在 ch01-00-introduction.md 文件，是否可删除？

英文版中不存在 ch01-00-introduction.md 文件，但是在中文版中存在此文件，是否可以删除？
如果可以删除的话，我就提交一个 pr。

Trait 建议翻译为 特质

个人理解，Rust的设计**是，Trait组合胜于模板继承（类继承），也就是常说的组合胜于继承，因此只有Trait而没有Class。如果需要提到这一概念，使用“特质组合”比“特征组合”（Rust社区似乎倾向于 特征 这个翻译）要更顺口。 而且 Trait 中可以包含默认实现， “特质”听起来像是有重量的东西，而“特征”、“特性”则更像没有质量的抽象概念。

一些有疑点的表述

The following code shows how you’d use each one in a let statement:

// subtraction
let difference = 95.5 - 4.3;

你说介绍个数字运算符吧，老实的介绍也就罢了，和 let 语句有毛线的关系？我还以为是介绍 let 语句的

Ch10-03示例10-20下的第三段错字

原文是：现在我们已经在一个具体的例子中展示了引用的声明周期位于何处，此处的“声明”应该是“生命”。

另一个简体中文翻译库

https://github.com/3442853561/rustbook-zh-cn
你们应该合作

建议 scalar

scalar 早年翻译 标量，实在是有点胡扯的嫌疑。没有几个人记得与矢量相对应。
现在不少人已经采用 纯量 一词。或者 无向量。
简单量，简单值，简单数，类似的名词 最容易让人理解。
名词是人类战争的根源。

再所谓，名不正则言不顺！

ch09-02章节的示例标号与原版不一致

ch09-02章节的示例标号与原版不一致

这样导致了一些问题，比如：

其功能再一次与示例 9-5 和示例 9-5 保持一致，不过这是一个与众不同且更符合工程学的写法。

需求: 集成Travis-CI

留意到issues中有些源码中已经修复, 但是gitbooks.io仍然没有进行更新, 因此提出该需求, 以节约贡献者们的时间.

mod-和文件系统章节中，翻译与版本实际不符

翻译中是这样：
Cargo 默认会创建一个库 crate 除非指定其他项目类型，所以如果不像一直以来那样加入 --bin 参数则项目将会是一个库：

但是执行cargo new --help
--bin Use a binary (application) template [default]
--lib Use a library template

指令帮助说明，bin才是默认的方式。
没看过英文版本，不知道是翻译问题，还是英文版就错误。

ch19-01 段落重复

具体位置在 使用-extern-函数调用外部代码

红框这一段和上两段重复，且在英文版中没有找到对应段落。

会考虑创建个组织么 或者合并到官方的组织里?

如题

ch19-02中的lifetime bound

感觉ch19-02中的lifetime bound可译为生命周期绑定，从译文可以很容易理解是把一个类型的生命期绑定到至少和另一个类型的生命周期一样长.

文中的文档连接地址 建议全部改成绝对路径 点击跳转不对

比如 ../std/net/enum.IpAddr.html
改成
https://doc.rust-lang.org/std/net/enum.IpAddr.html
大大好厉害 膜拜

关于翻译（合作与两个版本的合并）

请您与我QQ联系好吗？3442853561

建议修改

https://kaisery.github.io/trpl-zh-cn/ch10-03-lifetime-syntax.html#结合泛型类型参数trait%20bounds%20和生命周期

这个是列表 10-21 中那个返回两个字符串 slice 中最长者的longest函数，不过带有一个额外的参数ann。ann的类型是泛型T，它可以被放入任何实现了where从句中指定的Display trait 的类型。这个额外的参数会在函数比较字符串 slice 的长度之前被打印出来，这也就是为什么Display trait bound 是必须的。因为生命周期也是泛型，生命周期参数'a和泛型类型参数T都位于函数名后的同一尖括号列表中。

---

最后一句话改成如下比较好，不然此处一个 ”因为“ 容易引发歧义让读者以为是在解释上一句话中 ”为什么 Display trait bound 是必须的“。

修改：因为生命周期也是泛型，#（所以）生命周期参数'a和泛型类型参数T都位于函数名后的同一尖括号列表中。

PDF的“确”字使用的是日文字体。

PDF 25页

Cargo 有一个机制来确保任何人在任何时候重新构建代码

这里的"确"字是日文字体。
详见：
https://www.google.com/search?q=%E7%A1%AE+%E6%97%A5%E6%96%87&ie=utf-8&oe=utf-8&client=firefox-b-ab

http://www.zdic.net/z/1f/js/786E.htm

typo in ch03-00-common-programming-concepts

通用编程概念

一些关键字目前没有相应的宫娥能，是为将来可能添加的功能保留的。

"宫娥能" should be "功能"

网站上用的字体是啥？

代码部分字体，感觉挺好看的

翻译不统一

https://kaisery.github.io/trpl-zh-cn/ch19-00-advanced-features.html

此处 supertrait 译为 炒鸡 trait 而此前出现的都为 父 trait

敢问这是有意而为之调侃一下 还是怎么样 总之建议统一或备注

看了下后文有备注 超（父） 这种就比较好

我就自行关闭了

ch03-02-data-types.md

注意英文原版中i32 已改成了u32
rust-lang/book@f4bce88

错别字

https://kaisery.github.io/trpl-zh-cn/ch15-02-deref.html
#函数和方法的隐式解引用强制多态
称为可能 -> 应该是 成为可能 吧

错别字： 声明周期 -> 生命周期

文字错误

https://kaisery.github.io/trpl-zh-cn/ch19-03-advanced-traits.html
#newtype-模式用以在外部类型上实现外部-trait

而孤儿规则组织我们直接这么做
---阻止

发现一个错误

在15.5节，listing15-23后面的一段。

One important part of this code is that the Messenger trait has one method, send, that takes an immutable reference to self and text of the message.

这些代码中一个重要部分是拥有一个方法 send 的 Messenger trait，其获取一个 self 的可变引用和文本信息。

这里应该是不可变引用，是个笔误吧。