Skip to content
This repository was archived by the owner on Sep 30, 2020. It is now read-only.

Commit c737e96

Browse files
committed
Fixed some translation issues and some Chinese typography issues
Fixed some translation issues to make the sentence more fluent, and some Chinese typography issues like spaces between Chinese characters and English characters.
1 parent 582659f commit c737e96

File tree

1 file changed

+22
-25
lines changed

1 file changed

+22
-25
lines changed

zh-CN/faq.md

Lines changed: 22 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ Rust 作为一种备选方案,可以提供高效的代码和舒适的抽象级
6464
这个项目由 Mozilla 控制?
6565
</a></h3>
6666

67-
不是。Rust 始于 2006 年 Graydon Hoare 的兼职项目,并持续了三年。Mozilla 在语言成熟到足以运行基本测试并展示其核心概念时于 2009 年开始参与。虽然它由 Mozilla 资助,但 Rust 是由来自世界各地的多样化的发烧友开发的。[Rust 团队](https://www.rust-lang.org/team.html) 由 Mozilla 和非 Mozilla 成员组成,`rustc`(Rust 的编译器)至今也有超过[一千名独立贡献者](https://github.com/rust-lang/rust/)
67+
不是。Rust 始于 2006 年 Graydon Hoare 的兼职项目,并持续了三年。Mozilla 在语言成熟到足以运行基本测试并展示其核心概念时于 2009 年开始参与。虽然它由 Mozilla 资助,但 Rust 是由来自世界各地的多样化的发烧友开发的。[Rust 团队](https://www.rust-lang.org/team.html)由 Mozilla 和非 Mozilla 成员组成,`rustc`(Rust 的编译器)至今也有超过[一千名独立贡献者](https://github.com/rust-lang/rust/)
6868

6969
[项目治理](https://github.com/rust-lang/rfcs/blob/master/text/1068-rust-governance.md)而言,
7070
Rust 由一个从全局角度出发,为项目设定愿景和优先事项的核心团队管理。
@@ -84,13 +84,13 @@ Rust 由一个从全局角度出发,为项目设定愿景和优先事项的核
8484
Mozilla 的哪些项目使用 Rust?
8585
</a></h3>
8686

87-
主要项目是 [Servo](https://github.com/servo/servo),它是 Mozilla 正在雕琢的一个实验性的浏览器引擎。Mozilla 还在努力[整合 Rust 组件](https://bugzilla.mozilla.org/show_bug.cgi?id=1135640) 到 Firefox。
87+
主要项目是 [Servo](https://github.com/servo/servo),它是 Mozilla 正在雕琢的一个实验性的浏览器引擎。Mozilla 还在努力[整合 Rust 组件](https://bugzilla.mozilla.org/show_bug.cgi?id=1135640)到 Firefox。
8888

8989
<h3><a href="#what-examples-are-there-of-large-rust-projects" name="what-examples-are-there-of-large-rust-projects">
9090
有哪些大型的 Rust 项目?
9191
</a></h3>
9292

93-
目前两个最大的 Rust 开源项目是 [Servo](https://github.com/servo/servo)[Rust 编译器](https://github.com/rust-lang/rust) 本身。
93+
目前两个最大的 Rust 开源项目是 [Servo](https://github.com/servo/servo)[Rust 编译器](https://github.com/rust-lang/rust)本身。
9494

9595
<h3><a href="#who-else-is-using-rust" name="who-else-is-using-rust">
9696
还有谁在使用 Rust?
@@ -117,7 +117,7 @@ TODO: Write this answer.
117117
那有很多种方式。您可以尝试:
118118

119119
-[users.rust-lang.org](https://users.rust-lang.org/) 发帖,这是官方的 Rust 用户论坛
120-
- 在官方的 [Rust IRC 频道](https://chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust) 询问 (irc.mozilla.org 上的 #rust)
120+
- 在官方的 [Rust IRC 频道](https://chat.mibbit.com/?server=irc.mozilla.org&channel=%23rust)询问 (irc.mozilla.org 上的 #rust)
121121
-[Stack Overflow](https://stackoverflow.com/questions/tagged/rust) 询问,加上 "rust" 标签
122122
-[/r/rust](https://www.reddit.com/r/rust) 发帖,这是非官方的 Rust 板块
123123

@@ -133,7 +133,7 @@ Rust 语言的版本控制是怎样的?
133133

134134
Rust 的语言版本遵循 [SemVer](http://semver.org/),如果更改修复了编译器错误、补丁安全漏洞,或更改调度或类型推断需要附加注明,则稳定 API 的向后不兼容更改允许在次要版本中出现。次要版本更改的更详细指南可以在[语言](https://github.com/rust-lang/rfcs/blob/master/text/1122-language-semver.md)[标准库](https://github.com/rust-lang/rfcs/blob/master/text/1105-api-evolution.md)的已批准 RFC 中找到。
135135

136-
Rust 维护三个「发行频道」:稳定版(stable)、测试版(beta)和开发版(nightly)。稳定版和测试版每六周更新一次,而在那时的开发版会变为新的测试版,测试版变为新的稳定版。标记为不稳定或者隐藏在特性门控后的语言和标准库特性只能在开发版上使用,新特性定位为不稳定,一旦被核心团队和相关的子团队批准的话是「无门控的」,这种方法允许实验性变更,并同时为稳定频道提供强有力的向后兼容保证。
136+
Rust 维护三个「发行频道」:稳定版(stable)、测试版(beta)和开发版(nightly)。稳定版和测试版每六周更新一次,而在那时的开发版会变为新的测试版,测试版变为新的稳定版。标记为不稳定或者隐藏在特性门控后的语言和标准库特性只能在开发版上使用,新特性最初会被标记为不稳定,一旦被核心团队和相关的子团队批准的话就变成「通过门控的(ungated)」,这种方法允许实验性变更,并同时为稳定频道提供强有力的向后兼容保证。
137137

138138
就相关的其他详细信息,请阅读 Rust 博客 [「Stability as a Deliverable」](http://blog.rust-lang.org/2014/10/30/Stability.html)
139139

@@ -150,7 +150,7 @@ Rust 维护三个「发行频道」:稳定版(stable)、测试版(beta
150150
什么是「特性门控」(Feature Gates)?
151151
</a></h3>
152152

153-
「特性门控」(Feature Gates)是 Rust 用来稳定编译器、语言和标准库特性的机制。一个「门控」的特性只能在 nightly 发布渠道才能使用,而且必须显式指定了 `#[feature]` 属性或者命令行参数 `-Z unstable-options`。当一个特性稳定了,它才能在稳定版上可用,不需要显式启用。此时,这个特性被认为是通过门控的(ungated)。特性门控允许开发者在稳定版提供之前,在开发中测试试验性的功能。
153+
「特性门控」(Feature Gates)是 Rust 用来稳定编译器、语言和标准库特性的机制。一个受「门控」的特性只能在 nightly 发布渠道才能使用,且必须显式指定 `#[feature]` 属性或者命令行参数 `-Z unstable-options`。当一个特性稳定了,它才能在稳定版上可用,不需要显式启用。此时,这个特性被认为是通过门控的(ungated)。特性门控允许开发者在稳定版提供之前,在开发中测试试验性的功能。
154154

155155
<h3><a href="#why-a-dual-mit-asl2-license" name="why-a-dual-mit-asl2-license">
156156
为什么采用 MIT/ASL2 双许可证?
@@ -180,22 +180,19 @@ Rust 有多快?
180180
Rust 会垃圾收集吗?
181181
</a></h3>
182182

183-
不会。Rust 的重要创新之一就是保证内存安全( segfaults),*无需*垃圾收集。
183+
不会。Rust 的重要创新之一就是保证内存安全(无段错误 segfaults),*无需*垃圾收集。
184184

185185
通过避免垃圾收集(GC),Rust 可以提供许多益处:可预测的资源清理,降低内存管理开销,基本上没有运行时系统。这些特征使 Rust 很容易嵌入到任意上下文,并使其更容易[集成 Rust 代码到有 GC 的语言](http://calculist.org/blog/2015/12/23/neon-node-rust/)
186186

187-
Rust 通过其所有权和借用(borrowing)系统避免了垃圾收集的需求,而同一系统也有助于解决许多其他问题,包括
188-
[一般的资源管理](http://blog.skylight.io/rust-means-never-having-to-close-a-socket/)[并发](http://blog.rust-lang.org/2015/04/10/Fearless-Concurrency.html)
187+
Rust 通过其所有权和借用(borrowing)系统避免了垃圾收集的需求,而同一系统也有助于解决许多其他问题,包括[一般的资源管理](http://blog.skylight.io/rust-means-never-having-to-close-a-socket/)[并发](http://blog.rust-lang.org/2015/04/10/Fearless-Concurrency.html)
189188

190-
如果单一的所有权不够,Rust 程序依赖标准的引用计数智能指针类型,[`Rc`](https://doc.rust-lang.org/std/rc/struct.Rc.html),及其线程安全版的[`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html),而不是 GC。
189+
如果单一的所有权不够,Rust 程序依赖标准的引用计数智能指针类型,[`Rc`](https://doc.rust-lang.org/std/rc/struct.Rc.html),及其线程安全版的 [`Arc`](https://doc.rust-lang.org/std/sync/struct.Arc.html),而不是 GC。
191190

192191
不过,我们也在调查*可选*的垃圾收集作为一项未来扩展。
193192
其目标旨在顺利与有垃圾收集的运行时整合,
194193
例如由
195194
[Spidermonkey](https://developer.mozilla.org/en-US/docs/Mozilla/Projects/SpiderMonkey)
196-
[V8](https://developers.google.com/v8/?hl=en) JavaScript 引擎所提供的那些。
197-
最后,有人已调研了无编译器支持实现的
198-
[纯 Rust 垃圾收集器](https://manishearth.github.io/blog/2015/09/01/designing-a-gc-in-rust/)
195+
[V8](https://developers.google.com/v8/?hl=en) JavaScript 引擎所提供的那些。 最后,有人已调研了无编译器支持实现的[纯 Rust 垃圾收集器](https://manishearth.github.io/blog/2015/09/01/designing-a-gc-in-rust/)
199196
200197

201198
<h3><a href="#why-is-my-program-slow" name="why-is-my-program-slow">
@@ -312,7 +309,7 @@ fn is_odd(x: i64) -> bool {
312309
为什么 <code>match</code> 必须是穷举的?
313310
</a></h3>
314311

315-
有助于重构和清晰
312+
有助于重构和明确性
316313

317314
首先,如果 `match` 涵盖了所有的可能性,将来在 `enum` 中添加变量将导致编译失败,而不是运行时错误。这种类型的编译器辅助使得在 Rust 中大胆地重构成为可能。
318315

@@ -335,7 +332,7 @@ match val.do_something() {
335332

336333
对于这两者的选择取决于程序的目的。
337334

338-
如果你对浮点数的最大精度感兴趣,那么更倾向于选择 [`f64`][f64]。如果你更注重于保持数值占用更小的空间,或者更高的效率,而不关心每个数值具有较少的位而失去一些精确性,则选择 [`f32`][f32] 会更好。在 [`f32`][f32] 上的操作通常更快,即使在 64 位的硬件上也是如此。作为一个常见的例子,图形编程通常使用 [`f32`][f32] 因为它需要更高的性能,而且 32 位浮点数足以表示屏幕上的像素。
335+
如果你对浮点数的最大精度感兴趣,那么更倾向于选择 [`f64`][f64]。如果你更注重于保持数值占用更小的空间,或者更高的效率,而不关心由于每个数值具有较少的位而失去一些精确性,则选择 [`f32`][f32] 会更好。在 [`f32`][f32] 上的操作通常更快,即使在 64 位的硬件上也是如此。作为一个常见的例子,图形编程通常使用 [`f32`][f32] 因为它需要更高的性能,而且 32 位浮点数足以表示屏幕上的像素。
339336

340337
如果有疑问,请选择 [`f64`][f64] 以获得更高的精度。
341338

@@ -349,7 +346,7 @@ match val.do_something() {
349346

350347
浮点数不是全序或等价的,因为浮点值 [`NaN`](https://en.wikipedia.org/wiki/NaN) 既不小于,也不大于,或者等于其它任何浮点数或者自身。
351348

352-
因为浮点数没有实现 [`Eq`][Eq][`Ord`][Ord],它们不能用于 trait 约束要求是这些 trait 的地方,例如 [`BTreeMap`][BTreeMap][`HashMap`][HashMap]。这很重要,因为这些类型*假设*它们的键提供一个全序或完全等价的关系,否则将失败。
349+
因为浮点数没有实现 [`Eq`][Eq][`Ord`][Ord],它们不能用于 trait 约束要求是这两种 trait 的地方,例如 [`BTreeMap`][BTreeMap][`HashMap`][HashMap]。这很重要,因为这些类型*假设*它们的键提供一个全序或完全等价的关系,否则将失败。
353350

354351
有一个[](https://crates.io/crates/ordered-float)提供了对 [`f32`][f32][`f64`][f64][`Ord`][Ord][`Eq`][Eq] 的实现的封装,可能在某些情况下会有用。
355352

@@ -363,14 +360,14 @@ match val.do_something() {
363360
为什么 Rust 没有递增或递减操作符?
364361
</a></h3>
365362

366-
先增和后增(以及相对就的减法)虽然方便,但也相当复杂。它们都要求要对运算顺序的了解,而且经常导致 C 和 C++ 中的细节错误和未定义的行为。 `x = x + 1``x += 1` 只是略长一点,但更加明确。
363+
先增和后增(以及相对应的减法)虽然方便,但也相当复杂。它们都需要求值顺序的知识,而且经常导致 C 和 C++ 中的细节错误和未定义的行为。 `x = x + 1``x += 1` 只是略长一点,但更加明确。
367364
<h2 id="strings">字符串</h2>
368365

369366
<h3><a href="#how-to-convert-string-or-vec-to-slice" name="how-to-convert-string-or-vec-to-slice">
370-
如果将 <code>String</code> 或 <code>Vec&lt;T&gt;</code> 转换成切片(<code>&amp;str</code> 和 <code>&amp;[T]</code>)?
367+
如何将 <code>String</code> 或 <code>Vec&lt;T&gt;</code> 转换成切片(<code>&amp;str</code> 和 <code>&amp;[T]</code>)?
371368
</a></h3>
372369

373-
通常,你可以在需要切片的地方转入 `String``Vec<T>`。使用[强制解引(Deref)](https://doc.rust-lang.org/stable/book/deref-coercions.html),在用 `&``&mut` 传递引用时,[`String`][String][`Vec`][Vec] 会自动强制转换为对应的切片。
370+
通常,你可以在需要切片的地方传入 `String``Vec<T>`。使用[强制解引(Deref)](https://doc.rust-lang.org/stable/book/deref-coercions.html),在用 `&``&mut` 传递引用时,[`String`][String][`Vec`][Vec] 会自动强制转换为对应的切片。
374371

375372
`&str``&[T]` 上实现的方法可以直接在 `String``Vec<T>` 上访问。例如,即使 `char_at``&str` 上的方法,而 `some_string` 是一个 `String``some_string.char_at(0)` 也可以运行。
376373

@@ -407,7 +404,7 @@ fn say_hello(name: &str) {
407404

408405
做不到。至少在缺少对你所说的「字符(character)」充分的理解,并且缺少用于查找所需字符的索引而对字符串的预处理的情况下,无法做到。
409406

410-
Rust 字符串是用 UTF-8 编码的。UTF-8 中的单个可见字符不一定单个字节,除非它是用 ASCII 编码的字符串。每个字节被称为「码元(code unit)」(在 UTF-16 中,码元是 2 字节,在 UTF-32 中码元是 4 字节)。「码位(code point)」由一个或多个码元组成,并由此结合成「grapheme cluster」,这是最接近字符的概念了。
407+
Rust 字符串是用 UTF-8 编码的。UTF-8 中的单个可见字符不一定是单个字节,除非它是用 ASCII 编码的字符串。每个字节被称为「码元(code unit)」(在 UTF-16 中,码元是 2 字节,在 UTF-32 中码元是 4 字节)。「码位(code point)」由一个或多个码元组成,并由此结合成「grapheme cluster」,这是最接近字符的概念了。
411408

412409
因此,即使你可以在 UTF-8 字符串中索引字节,你也不能在常数时间里访问第 `i` 个码元或 grapheme cluster。但是,如果你知道所需的 code point 或 grapheme cluster 开始的字节的位置,那么你 _可以_ 在常数时间时访问它。包括 [`str::find()`][str__find] 和正则匹配函数都返回字节索引,以便于此类的访问。
413410

@@ -510,7 +507,7 @@ for item in &v {
510507
println!("\nLength: {}", v.len());
511508
```
512509

513-
Rust 的 `for` 循环对于任何迭代都调用 `into_iter()`(在[`IntoIterator`][IntoIterator] trait 中定义)。任何实现了 [`IntoIterator`][IntoIterator] trait 的类型都可以用在 `for` 循环中。 [`IntoIterator`][IntoIterator] 是对针 [`&Vec`][Vec][`&mut Vec`][Vec] 实现的,所以 `into_iter()` 返回的迭代器只是借用集合的内容,而不是移动/消费它们。其它标准集合也是如此。
510+
Rust 的 `for` 循环对于任何迭代都调用 `into_iter()`(在 [`IntoIterator`][IntoIterator] trait 中定义)。任何实现了 [`IntoIterator`][IntoIterator] trait 的类型都可以用在 `for` 循环中。 [`IntoIterator`][IntoIterator] 是对针 [`&Vec`][Vec][`&mut Vec`][Vec] 实现的,所以 `into_iter()` 返回的迭代器只是借用集合的内容,而不是移动/消费它们。其它标准集合也是如此。
514511

515512
如果需要移动/消费迭代器,在迭代中用没有 `&``&mut``for`
516513

@@ -610,7 +607,7 @@ fn main() {
610607

611608
理解借用检查器是重要的环节是实践。Rust 的强静态分析保证与许多程序员以往接触过的有天壤之别。需要花些时间来适应这些。
612609

613-
如果你发现你在借用检查器中遇到困难,或者失去耐心,可以随时联系 [Rust 社区](community.thml) 寻求帮助。
610+
如果你发现你在借用检查器中遇到困难,或者失去耐心,可以随时联系 [Rust 社区](community.thml)寻求帮助。
614611

615612
<h3><a href="#when-is-rc-useful" name="when-is-rc-useful">
616613
<code>Rc</code> 在什么时候有用?
@@ -656,7 +653,7 @@ Rust 的非原子引用计数指针类型,在官方文档中涵盖了 [`Rc`][R
656653
为什么有生命周期?
657654
</a></h3>
658655

659-
生命周期是 Rust 以于内存安全问题的解答。它允许 Rust 确保内存安全,而无需付出垃圾收集的性能代价。这是基于多种学术成果的,这些参考文献可以从 [Rust 之书](https://doc.rust-lang.org/stable/book/bibliography.html#type-system) 中找到。
656+
生命周期是 Rust 以于内存安全问题的解答。它允许 Rust 确保内存安全,而无需付出垃圾收集的性能代价。这是基于多种学术成果的,这些参考文献可以从 [Rust 之书](https://doc.rust-lang.org/stable/book/bibliography.html#type-system)中找到。
660657

661658
<h3><a href="#why-is-the-lifetime-syntax-the-way-it-is" name="why-is-the-lifetime-syntax-the-way-it-is">
662659
为什么生命周期语法是这样的?
@@ -884,7 +881,7 @@ Rust 中如何进行异步输入 / 输出?
884881

885882
异常使对于控制流的理解复杂化,它们表示了类型系统之外的有效性/无效性,而且它们与多线程代码(Rust 的主要关注点)交互并不佳。
886883

887-
Rust 更倾向于使用基于类型的错误处理方式,在 [这本书中有详细的介绍](https://doc.rust-lang.org/stable/book/error-handling.html)。这会更适合 Rust 的控制流,并发和其它所有的特性。
884+
Rust 更倾向于使用基于类型的错误处理方式,在[这本书中有详细的介绍](https://doc.rust-lang.org/stable/book/error-handling.html)。这会更适合 Rust 的控制流,并发和其它所有的特性。
888885

889886
<h3><a href="#whats-the-deal-with-unwrap" name="whats-the-deal-with-unwrap">
890887
到处都有 <code>unwrap()</code> 是怎么回事?
@@ -918,7 +915,7 @@ Rust 更倾向于使用基于类型的错误处理方式,在 [这本书中有
918915

919916
在同步的情况下,修改是安全的。修改一个静态的 [`Mutex`][Mutex] (通过 [lazy-static](https://crates.io/crates/lazy_static/) 包进行延迟初始化)不需要用 `unsafe` 块,修改一个静态的 [`AtomicUsize`][AtomicUsize] (可以不用 lazy_staic 初始化)也是一样。
920917

921-
更一般来说,如果一个类型实现了 [`Sync`][Sync] 而且不实现 [`Drop`][Drop],它就 [可以被用作 `static`](https://doc.rust-lang.org/book/const-and-static.html#static)
918+
更一般来说,如果一个类型实现了 [`Sync`][Sync] 而且不实现 [`Drop`][Drop],它就[可以被用作 `static`](https://doc.rust-lang.org/book/const-and-static.html#static)
922919

923920
<h2 id="macros">宏</h2>
924921

0 commit comments

Comments
 (0)