mirror of
https://github.com/krahets/hello-algo.git
synced 2024-12-25 14:56:28 +08:00
184 lines
5.1 KiB
Markdown
184 lines
5.1 KiB
Markdown
# 如何使用本书
|
||
|
||
**强烈建议通读本节内容,以获取最佳学习体验**。
|
||
|
||
## 行文风格约定
|
||
|
||
标题后标注 `*` 的是选读章节,内容相对较难。如果你的时间有限,建议可以先跳过。
|
||
|
||
文章中的重要名词会用 `「括号」` 标注,例如 `「数组 Array」` 。建议记住这些名词,包括英文翻译,以便后续阅读文献时使用。
|
||
|
||
重点内容、总起句、总结句会被 **加粗** ,此类文字值得特别关注。
|
||
|
||
专有名词和有特指含义的词句会使用 `“双引号”` 标注,以避免歧义。
|
||
|
||
本书部分放弃了编程语言的注释规范,以换取更加紧凑的内容排版。注释主要分为三种类型:标题注释、内容注释、多行注释。
|
||
|
||
=== "Java"
|
||
|
||
```java title=""
|
||
/* 标题注释,用于标注函数、类、测试样例等 */
|
||
|
||
// 内容注释,用于详解代码
|
||
|
||
/**
|
||
* 多行
|
||
* 注释
|
||
*/
|
||
```
|
||
|
||
=== "C++"
|
||
|
||
```cpp title=""
|
||
/* 标题注释,用于标注函数、类、测试样例等 */
|
||
|
||
// 内容注释,用于详解代码
|
||
|
||
/**
|
||
* 多行
|
||
* 注释
|
||
*/
|
||
```
|
||
|
||
=== "Python"
|
||
|
||
```python title=""
|
||
""" 标题注释,用于标注函数、类、测试样例等 """
|
||
|
||
# 内容注释,用于详解代码
|
||
|
||
"""
|
||
多行
|
||
注释
|
||
"""
|
||
```
|
||
|
||
=== "Go"
|
||
|
||
```go title=""
|
||
/* 标题注释,用于标注函数、类、测试样例等 */
|
||
|
||
// 内容注释,用于详解代码
|
||
|
||
/**
|
||
* 多行
|
||
* 注释
|
||
*/
|
||
```
|
||
|
||
=== "JavaScript"
|
||
|
||
```javascript title=""
|
||
/* 标题注释,用于标注函数、类、测试样例等 */
|
||
|
||
// 内容注释,用于详解代码
|
||
|
||
/**
|
||
* 多行
|
||
* 注释
|
||
*/
|
||
```
|
||
|
||
=== "TypeScript"
|
||
|
||
```typescript title=""
|
||
/* 标题注释,用于标注函数、类、测试样例等 */
|
||
|
||
// 内容注释,用于详解代码
|
||
|
||
/**
|
||
* 多行
|
||
* 注释
|
||
*/
|
||
```
|
||
|
||
=== "C"
|
||
|
||
```c title=""
|
||
/* 标题注释,用于标注函数、类、测试样例等 */
|
||
|
||
// 内容注释,用于详解代码
|
||
|
||
/**
|
||
* 多行
|
||
* 注释
|
||
*/
|
||
```
|
||
|
||
=== "C#"
|
||
|
||
```csharp title=""
|
||
/* 标题注释,用于标注函数、类、测试样例等 */
|
||
|
||
// 内容注释,用于详解代码
|
||
|
||
/**
|
||
* 多行
|
||
* 注释
|
||
*/
|
||
```
|
||
|
||
=== "Swift"
|
||
|
||
```swift title=""
|
||
/* 标题注释,用于标注函数、类、测试样例等 */
|
||
|
||
// 内容注释,用于详解代码
|
||
|
||
/**
|
||
* 多行
|
||
* 注释
|
||
*/
|
||
```
|
||
|
||
=== "Zig"
|
||
|
||
```zig title=""
|
||
// 标题注释,用于标注函数、类、测试样例等
|
||
|
||
// 内容注释,用于详解代码
|
||
|
||
// 多行
|
||
// 注释
|
||
```
|
||
|
||
## 在动画图解中高效学习
|
||
|
||
视频和图片相比于文字的信息密度和结构化程度更高,更容易理解。在本书中,**知识重难点会主要以动画、图解的形式呈现**,而文字的作用则是作为动画和图的解释与补充。
|
||
|
||
阅读本书时,若发现某段内容提供了动画或图解,**建议你以图为主线**,将文字内容(一般在图的上方)对齐到图中内容,综合来理解。
|
||
|
||
![动画图解示例](suggestions.assets/animation.gif)
|
||
|
||
## 在代码实践中加深理解
|
||
|
||
本书的配套代码托管在[GitHub 仓库](https://github.com/krahets/hello-algo),**源代码包含详细注释,配有测试样例,可以直接运行**。
|
||
|
||
- 若学习时间紧张,**建议至少将所有代码通读并运行一遍**。
|
||
- 若时间允许,**强烈建议对照着代码自己敲一遍**。相比于读代码,写代码的过程往往能带来新的收获。
|
||
|
||
![运行代码示例](suggestions.assets/running_code.gif)
|
||
|
||
**第一步:安装本地编程环境**。参照[下节内容](https://www.hello-algo.com/chapter_preface/installation/),如果已有可直接跳过。
|
||
|
||
**第二步:下载代码仓**。如果已经安装 [Git](https://git-scm.com/downloads) ,可以通过命令行来克隆代码仓。
|
||
|
||
```shell
|
||
git clone https://github.com/krahets/hello-algo.git
|
||
```
|
||
|
||
当然,你也可以点击“Download ZIP”直接下载代码压缩包,本地解压即可。
|
||
|
||
![克隆仓库与下载代码](suggestions.assets/download_code.png)
|
||
|
||
**第三步:运行源代码**。若代码块的顶部标有文件名称,则可在仓库 `codes` 文件夹中找到对应的 **源代码文件**。源代码文件可以帮助你省去不必要的调试时间,将精力集中在学习内容上。
|
||
|
||
![代码块与对应的源代码文件](suggestions.assets/code_md_to_repo.png)
|
||
|
||
## 在提问讨论中共同成长
|
||
|
||
阅读本书时,请不要“惯着”那些弄不明白的知识点。**欢迎在评论区留下你的问题**,小伙伴们和我都会给予解答,您一般 2 日内会得到回复。
|
||
|
||
同时,也希望你可以多花时间逛逛评论区。一方面,可以看看大家遇到了什么问题,反过来查漏补缺,这往往可以引起更加深度的思考。另一方面,也希望你可以慷慨地解答小伙伴们的问题、分享自己的见解,大家互相学习与进步!
|
||
|
||
![评论区示例](suggestions.assets/comment.gif)
|