diff --git a/book/contents/SUMMARY.md b/book/contents/SUMMARY.md index 9d65e075..b9f21b68 100644 --- a/book/contents/SUMMARY.md +++ b/book/contents/SUMMARY.md @@ -2,6 +2,7 @@ [进入Rust编程世界](into-rust.md) [关于本书](about-book.md) +[避免从入门到放弃](sth-you-should-not-do.md) ## Getting started @@ -100,9 +101,10 @@ - [同时运行多个Future](async/multi-futures-simultaneous.md) - [一些疑难问题的解决办法](async/pain-points-and-workarounds.md) - [实践应用:Async Web服务器](async/web-server.md) - - [tokio todo](async/tokio/intro.md) - - [基本用法](async/tokio/basic.md) - - [异步消息流](async/tokio/stream.md)) + +- [tokio使用指南](tokio/intro.md) + - [基本用法](tokio/basic.md) + - [异步消息流](tokio/stream.md)) - [Rust最佳实践 doing](practice/intro.md) - [日常开发三方库精选](practice/third-party-libs.md) @@ -139,7 +141,9 @@ - [奇怪的序列x..y](pitfalls/weird-ranges.md) - [无处不在的迭代器](pitfalls/iterator-everywhere.md) - [线程间传递消息导致主线程无法结束](pitfalls/main-with-channel-blocked.md) - + +- [如何实现一个链表]() + - [进阶类型转换](converse/intro.md) - [枚举和整数](converse/enum-int.md) diff --git a/book/contents/async/tokio/intro.md b/book/contents/async/tokio/intro.md deleted file mode 100644 index f07cf621..00000000 --- a/book/contents/async/tokio/intro.md +++ /dev/null @@ -1 +0,0 @@ -# 定海神针-tokio包 diff --git a/book/contents/sth-you-should-not-do.md b/book/contents/sth-you-should-not-do.md new file mode 100644 index 00000000..236b1b69 --- /dev/null +++ b/book/contents/sth-you-should-not-do.md @@ -0,0 +1,61 @@ +# 避免从入门到放弃 +很多人都在学Rust ing,也有很多人在放弃 ing。想要顺利学完 Rust,大家需要谨记本文列出的内容,否则这极有可能是又又又一次从入门到放弃之旅。 + +Rust 是一门全新的语言,它会带给你前所未有的体验,提升你的通用编程水平,甚至于赋予你全新的编程思想。在此时此刻,大家可能还半信半疑,但是当学完它再回头看时,可能你也会认同这些貌似浮夸的赞美。 + +## 避免试一试的心态 +在学习Go、Python等编程语言时,你可能会一边工作,一边轻松愉快的学习它们,但是Rust不行。原因如文章开头所说,在学习Rust的同时你会收获很多语言之外的知识,因此 Rust 在入门阶段比很多编程语言要更难,但是一旦入门,你将收获一个全新的自己,成为一个更加优秀的程序员。 + +在学习过程中,一开始可能会轻松愉快,但是在开始Rust核心概念时(所有权、借用、生命周期、智能指针等),难度可能会陡然提升,此时就需要认真对待起来,否则会为后面埋下很多难以填补的坑,结果最后你可能只有两个选择:重新学一遍 or 放弃。 + +因此,在学习过程中,给大家三点建议: +- 要提前做好会遇到困难的准备,因为如上面所说,学习Rust不仅仅是在学习一门编程语言 +- 不要抱着试一试的心态去试一试,否则是浪费时间和消耗学习的激情,作为连续六年全世界最受喜欢的语言,Rust不仅仅是值得试一试 :) +- 深入学习一本好书或教程 + +总之, Rust 入门难,但是在你一次次克服艰难险阻的同时,也一次次收获了与众不同的编程经验,最后历经九九八十一难,立地成大佬。 给自己一个机会,也给 Rust 一个机会 :) + +## 深入学习一本好书 +Rust跟其它语言不一样,你无法看了一遍语法,然后就能上手写代码,对,我说的就是对比 Go 语言,后者的简单易用是有目共睹的。 + +这些年,我遇到过太多在网上看了一遍菜鸟教程(或其它简易教程)就上手写demo甚至项目的同学,无一例外,都各种碰壁、趟坑,最后要么放弃,要么回炉重造,之前的时间和精力基本等同浪费。 + +因此,大家一定要舍得投入时间,沉下心去读一本好书,这本书会带你深入浅出地学习使用Rust所需的各种知识,还会带你提前趟坑,这些坑往往是需要大量的时间才能领悟的。 + +在以前我可能会推荐看官方那本书的英文原版 + async book + nomicon这几本书的组合,但是现在有了一本更适合中国用户的书籍,那就是 [<>](https://github.com/sunface/rust-course),内容好坏大家一读即知,光就文字而言,那绝对是行云流水般的阅读体验,可以极大提升你的学习效率,也不再因为反复读也读不懂一句话而烦闷不堪。 + +## 千万别从链表或图开始练手 +CS课程中我们会学习大量的常用数据结构和算法,因此大家都养成了一种好习惯:学习一门新语言,先用它写个链表或图试试。 + +我的天,在Rust中千万别这么干,你是在扼杀自己之前的努力!因为不像其它语言,链表在Rust中简直是地狱一般的难度,我见过太多英雄好汉难过链表关,最终黯然退幕。我不希望正在阅读此文的你也成为其中一个 :( + +这些自引用类型的数据结构(包含了字段,该字段又引用了自身),它们是恶魔,它们不仅仅在蹂躏着新手,还在折磨着老手,有意思的是,它们的难恰恰是Rust的优点导致的:无gc也无手动内存管理,内存安全。 + +这两点的实现并不是凭空产生的,而是通过Rust一套非常强大、优美的机制提供了支持,这些机制一旦你学到,就会被它巧妙的构思和设计而征服,进而被 Rust 深深吸引!但是一切选择都有利弊,这种机制的弊端就在于实现链表这种数据结构时,会变得非常非常复杂。 + +你需要糅合各种知识,才能解决这个问题,但是这显然不是一个新手应该独自去面对的。总之,不会链表对于Rust的学习和写项目,真的没有任何影响,直接使用大神已经写好的数据结构包就可以。 + +如果想要练手,我们可以换个方向开始,当然如果你就是喜欢征服困难,那没问题,就从链表开始。但是无论选择哪个,之前提到的那本书都会给你莫大的帮助,包括如何实现一个链表! + +## 仔细阅读编译错误 +在一些编程语言中,你可能习惯了编译器给出的错误只要看前面(或后面)几行就行,大部分是不怎么用到的信息,总之编译器总感觉笨笨的。 + +但是 Rust 不是,它为我们提供了一个强大无比的编译器,而且会提示我们该如何修改代码以解决错误,简直就是一个优秀的老师! + +因此在使用 Rust 过程中,如果错误你不知该如何解决,不妨仔细阅读下编译器或者IDE给出的错误提示,绝大多数时候,你都可以通过这些提示顺利的解决问题。 + +同时也不要忽略编译器给出的警告信息(warnings),因为里面包含了 `cargo clippy` 给出的 `lint` 提示,这些提示不仅仅包含代码风格,甚至包含了一些隐藏很深的错误!至于这些错误为何不是 `error` 形式出现,随着学习的深入,你将逐渐理解 Rust 的各种设计选择,包括这个问题。 + +## 不要强制自己使用其它编程语言的最佳实践来写Rust +大多数其它编程语言适用的最佳实践在Rust中也可以很好的使用,但是 Rust 并不是一门专门的面向对象或者函数式语言,因此在使用自己喜欢的编程风格时,也要考虑遵循 Rust 应有的实践。 + +例如纯面向对象或纯函数式编程,在 Rust 中就并不是一个很好的选择。如果你有过Go语言的编程经验,相信能更加理解我这里想表达的含义。 + +不过大家也不用担心,在书中我们以专题的形式专门讲解 Rust 的最佳实践,看完后自然就明白了。 + + + +## 总结 +对于新手而言,最应该避免的就是从**链表开始练手**,最应该做的就是认真仔细地学习一本优秀的书。 + +总之,认真学 Rust,既然选择了,就相信自己,你的前方会是星辰大海! \ No newline at end of file diff --git a/book/contents/test/intergration.md b/book/contents/test/intergration.md index ec7352e7..f8c693dc 100644 --- a/book/contents/test/intergration.md +++ b/book/contents/test/intergration.md @@ -1 +1,3 @@ # 集成测试 + +https://www.reddit.com/r/rust/comments/s9zs5c/how_do_you_debug_a_rust_library_after_compilation/ \ No newline at end of file diff --git a/book/contents/async/tokio/basic.md b/book/contents/tokio/basic.md similarity index 100% rename from book/contents/async/tokio/basic.md rename to book/contents/tokio/basic.md diff --git a/book/contents/tokio/intro.md b/book/contents/tokio/intro.md new file mode 100644 index 00000000..f2e3444a --- /dev/null +++ b/book/contents/tokio/intro.md @@ -0,0 +1 @@ +# tokio使用指南 diff --git a/book/contents/async/tokio/stream.md b/book/contents/tokio/stream.md similarity index 100% rename from book/contents/async/tokio/stream.md rename to book/contents/tokio/stream.md diff --git a/book/writing-material/posts/wasm.md b/book/writing-material/posts/wasm.md index e69de29b..8001670c 100644 --- a/book/writing-material/posts/wasm.md +++ b/book/writing-material/posts/wasm.md @@ -0,0 +1 @@ +https://www.reddit.com/r/rust/comments/s9yugv/compile_rust_to_wasm_and_import_as_typescript/ \ No newline at end of file