1.介绍.html
我们使用了mut来使x可变：再（在） Rust 中绑定是默认是不可变的。在下面的例子中这个 vector 是可变的。

比如Vector，Tuple等表示数据结构的名词，翻译成向量、元组的话不如直接使用英文直观。比如“向量”容易和数学上向量的概念混淆。
翻了一下《C++ Primer》和《Thinking in Java》这两本比较经典的入门书籍，里面关于Vector、Map、Set等数据结构，大都不进行翻译。

Slice 是否翻译为“切片”更好？
我之前接触的编程语言里只有Python有类似的功能，而这功能在Python的翻译一般翻译为“切片”。不知道其他语言怎样翻译。

Trait 这个好像是Rust特有的关键字？翻译成“特性”的话，如果我之前没了解过Rust的Trait，光看“特性”的话有点难对上这个关键字。

参考：
[1] C++ Primer 4th edition
[2] Thinking in Java 3rd edition
[3] Python教程 - 廖雪峰的翻译

rustcc/RustPrimer#1

提示如下：

Template render error: (E:\libs\rust-book-chinese\content\Macros 宏.md) [Line 12
7, Column 9]
  unexpected token: . (In file 'content/Macros 宏.md')

源码如下：

macro_rules! foo {
    () => {{
        ...
    }}
}

unit-like struct被翻译为“类单元结构体”，但在介绍这个概念的最后一句话中，它被翻译成了“类似unit的结构体”

难道不是应该翻译成外部函数接口么？

问一下有计划更新到1.10-stable么？

也许我可以掺乎掺乎，经验上看，翻译一下“* programming language”是个很好的学习方法：）

有些变形，应该把在线阅读的html标签内部的lang="zh-tw"改为lang="zh-Hans"。

这样会好看一点。

http://kaisery.gitbooks.io/rust-book-chinese/content/content/5.34.%60Deref%60%20coercions%20%60Deref%60%E5%BC%BA%E5%88%B6%E5%A4%9A%E6%80%81.html

这对编写自定义指针类型很有用。然而，这里有一个与Deref相关的语言功能：“解引用强制多态（deref coercions）”。规则如下：如果你有一个U类型，和它的实现Deref<Target=T>，（那么）&U的值将会自动转换为&T。这是一个栗子

“栗子” 错了

看起来高大上一些←_←

内容

电子书
[GitBook.com](https://www.gitbook.com/book/kaisery/rust-book-chinese)上的电子书中文字体已有所改善，请优先去这里下载:)
请使用 [GitBook](https://github.com/GitbookIO/gitbook) 来生成电子书。

问题

似乎也没有找到下载以及生成电子书pdf的方式，url好像也失效了。

...prints the file and line number of where that dbg! macro call occurs in your code...

被翻译为

...打印出你代码中 dbg! 宏调用的文件和行号...

这个说法看起来像是“dbg!宏调用了一个文件”，翻译为“...打印出你代码中调用 dbg! 宏时所在的文件和行号...”会不会更好一点？

另外

so we use a reference to dbg! in the next call.

这个原文似乎本身就有问题……代码中是给 dbg! 传递了一个引用，而不是使用了一个指向 dbg! 的引用，翻译为

所以我们在下一次调用中使用对 dbg! 的引用

是不符合代码的。是不是可以翻译时修正这个原文的错误，改为“ 所以我们在下一次调用 dbg! 时传递一个引用”

在
newtype 模式用以在外部类型上实现外部 trait
中：
Newtype 是一个源自 （U.C.0079，逃） Haskell 编程语言的概念。使用这个模式没有运行时性能惩罚，这个封装类型在编译时就被省略了。
有
（U.C.0079，逃）
与原文有出入[doge]

文档中许多链接已经失效，或者引向英文Rust Book。建议全部更新为GitBook中的固定连接。如章节5.7，5.8，5.16等

preface.md 的 rustbook.cn 这个链接已经失效了的样子（现在指向的链接惨不忍睹 😂），是不是拿掉比较好...

我们写的算法(Rust语言版)
http://arust.mydoc.io/

https://www.v2ex.com/t/970748

而且还声称出处是自己网站上的，虽然这个网站上的内容也是开源社区的，和他没关系

5# 另外，www.rustwiki.org.cn 这个网站一直是我个人在出钱维护，页面左下角有备案号，大家也可以直接在备案系统查询到。

英文版：Your code after this point needs to rely on not being in this bad state.
中文版：之后的代码的运行依赖于处于这种有害状态

中文版本应该是少了一个否定词。

我们写的算法(Rust语言版)
http://arust.mydoc.io/

发现有些地方跟英文版本的原文不对应，比如 5.3 原生类型这一节里面第87行是这么写的:

你可以用a.len()来获取a中元素的数量，用a.iter()在循环中迭代所有元素。下面的代码会按顺序打印每一个元素：

而我在现在官方的book的对应章节看到的是这样的:

You can get the number of elements in an array a with a.len():

有些句子官方的文档里面已经删掉了，我们这边的翻译要不要对应更新 ?

https://kaisery.gitbooks.io/rust-book-chinese/content/content/Benchmark%20tests%20基准测试.html

Search: 对于大的只 Replace to: 对于大的值

建议在第一次增加dependencies的位置，以“”译者注“之类的形式增加cargo mirror的说明。

对于不会翻墙的人，直接就放弃rust了。对于能翻墙的人，也可能某些时候没法翻墙，比如我现在在公司。

你这里翻译的5.8章和现在官网上stable的5.8章似乎有比较大的出入?

我也想加入 :)

个人总结：中文教程与英语教程最显著的区别是，英语教程几乎每句都会用到 "let's" "we should" "we can" "your project"，但阅遍名书名译（技术书籍），鲜见“让我们”“我们应该”“我们可以”“你的项目”等词语。中文这样的用法应该很少见吧。翻译此类文档我觉得应该去掉此类词语。

http://kaisery.gitbooks.io/rust-book-chinese/content/content/4.2.Testing%20%E6%B5%8B%E8%AF%95.html

文档测试

rust-book-chinese/content/2.3.Hello, Cargo!.md

Cargo.tgml 的文件内容如下 => Cargo.toml

“target-triple" 是 编译器的 专用术语，用 “ cpu- vendor- os" 来标识 交叉编译时的 系统类型， clang, gcc 都有用。 如下几个链接可以参考:
http://clang.llvm.org/docs/CrossCompilation.html#target-triple
https://www.gnu.org/software/autoconf/manual/autoconf-2.65/html_node/Specifying-Target-Triplets.html
http://wiki.osdev.org/Target_Triplet

翻译成“目标三围”感觉体现不出这个意思呢。

然而我也没有想到和找到比较好的翻译方式，^_^

可以添加一个术语中英文对照表，以统一翻译。也方便贡献者对已有的不当翻译做修订。

Rust语言中文社区 144605258
这里面也在组织book的翻译哦。

“The XX Programming Language” 这样的表达在国内的标准译法是： XX 程序设计语言。这在出版物中都已是公认的译法，比如：
K&R的 The C Programming Language 为《C 程序设计语言》，
Bjarne Stroustrup 的 The C++ Programming Language 为《C++ 程序设计语言》，
Go团队推出的著作 The Go Programming Language 为《Go 程序设计语言》，
松本行弘 的 The Ruby Programming Language 在国内也译成 《Ruby 程序设计语言》。

还有苹果官方的 The Swift Programming Language、C#之父 Anders Hejlsberg 的书籍 The C# Programming Language，Java之父 James Gosling 的书籍 The Java Programming Language等书。

The XX Programming Language 一般都是该语言的发明人或团队所出图书，通常被人称为 XX 语言的Bible，在美国一般人出书也不敢冒用此书名，在国内的《XX程序设计语言》书名也一般是留给 XX 语言的译作的。The Rust Programming Language 也一样在官方就叫此名，我们翻译书名时也应遵循官方的书名命名。

在此版中文版概述栏可填上：Rust 程序设计语言——Rust 官方教程（中文版）。
在书籍里面的内容将《Rust 编程语言》此说法全部换成《Rust 程序设计语言》。

就像这样：
https://github.com/t123yh/rust-book-chinese/blob/patch-1/content/2.3.Hello%2C%20Cargo!.m
这样便于追踪官方文档的更新并作出对应的修改。

4.8小节中的copy部分，primitive type被翻译为了基本类型，而在之前翻译为原生类型，如4.3小节标题。