@ -4,13 +4,13 @@
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					> < br > 
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					> commit 4f2dc564851dc04b271a2260c834643dfd86c724
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					现在已经安装好了 Rust,  让我们来编写第一个 Rust 程序。当学习一门新语言的时候,编写一个在屏幕上打印 “Hello, world!” 文本的小程序是一个传统,而在这一部分 将遵循这个传统。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					现在已经安装好了 Rust,  让我们来编写第一个 Rust 程序。当学习一门新语言的时候,使用该语言在屏幕上打印 “Hello, world!” 是一个传统,我们 将遵循这个传统。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					> 注意:  本书假设你熟悉基本的命令行操作。Rust 本身并不对你的编辑器,工具和你的代码存放在何处有什么特定的要求,所以如果你比起命令行 更喜欢 IDE,  请随意选择你喜欢的 IDE。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					> 注意:  本书假设你熟悉基本的命令行操作。Rust 本身并不对你的编辑器,工具和你的代码存放在何处有什么特定的要求,所以如果你更喜欢 IDE,  请随意选择你喜欢的 IDE。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					### 创建项目文件夹
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					首先,创建一个文件夹来存放 Rust 代码。Rust 并不关心你的代码存放在哪里,不过在本书中,我们建议在你的 home 目录创建一个 *projects*  目录,并把你的所有项目放在这。打开一个终端并输入如下命令来为这个 项目创建一个文件夹:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					首先,创建一个文件夹来存放 Rust 代码。Rust 并不关心你的代码存放在哪里,不过在本书中,我们建议在你的 home 目录创建一个 *projects*  目录,并把你的所有项目放在这。打开一个终端,输入如下命令来为 项目创建一个文件夹:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					Linux 和 Mac:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
	
		
			
				
					
						
							
								 
							 
						
						
							
								 
							 
						
						
					 
				
				 
				 
				
					@ -52,11 +52,11 @@ $ ./main
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					Hello, world!
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					```
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					在 Windows 上,运行`.\main.exe`而不是`./main`。不管使用何种系统,你应该在终端看到`Hello, world!`字符串。如果你做到了,那么恭喜你!你已经正式编写了一个 Rust 程序。你是 一名 Rust 程序员了!欢迎入坑。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					在 Windows 上,运行`.\main.exe`而不是`./main`。不管使用何种系统,你应该在终端看到`Hello, world!`字符串。如果你做到了,那么恭喜你!你已经正式编写了一个 Rust 程序,成为 一名 Rust 程序员了!欢迎入坑。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					### 分析 Rust 程序
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					现在,  让我们回过头来仔细看看“Hello, world!”程序到底发生了什么。这里是谜题的第一片:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					现在,让我们回过头来,  仔细看看“Hello, world!”程序到底发生了什么。这里是谜题的第一片:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					```rust
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					fn main() {
 
				
			 
			
		
	
	
		
			
				
					
						
						
						
							
								 
							 
						
					 
				
				 
				 
				
					@ -64,9 +64,9 @@ fn main() {
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					}
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					```
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					这几行定义了一个 Rust ** 函数**。`main`函数是特殊的:这是每一个可执行的 Rust 程序首先运行 的函数(译者注: 入口点)  。第一行表示“定义一个叫 `main`  的函数,没有参数也没有返回值。”如果有参数的话,它们应该出现在括号中,`(`和`)`。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					这几行定义了一个 Rust ** 函数**。`main`函数是特殊的:这是每一个可执行的 Rust 程序的入口点。第一行表示“定义一个叫 `main`  的函数,没有参数也没有返回值。”如果有参数的话,它们应该出现在括号中,`(`和`)`之间 。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					同时注意函数体被包裹在大括号中,`{`和`}`。Rust 要求所有函数体都位于大括号中(译者注:对比有些语言特定情况可以省略大括号)。将前一个大括号与函数声明置于一行,并留有一个空格被认为是一个 好的代码风格。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					同时注意函数体被包裹在大括号中,`{`和`}` 之间 。Rust 要求所有函数体都位于大括号中(译者注:有些语言函数体只有一行时可以省略大括号,但 Rust 中是不行的)。一般来说,将左大括号与函数声明置于一行,并以空格分隔,是良 好的代码风格。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					在`main()`函数中:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
	
		
			
				
					
						
						
						
							
								 
							 
						
					 
				
				 
				 
				
					@ -76,23 +76,23 @@ fn main() {
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					这行代码做了这个小程序的所有工作:它在屏幕上打印文本。这里有很多需要注意的细节。第一个是 Rust 代码风格使用 4 个空格缩进,而不是 1 个制表符(  tab)  。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					第二个重要的部分是`println!()`。这叫做 Rust ** 宏**,是如何进行 Rust 元编程(  metaprogramming)  的关键所在。相反如果是调用一个函数的话,  它应该看起来 像这样:`println`(没有`!`)。我们将在 21 章 E 小节中更加详细的讨论 Rust 宏,不过现在你只需记住当看到符号`!`的时候,就代表在调用一个宏而不是一个普通的 函数。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					第二个重要的部分是`println!()`。这是 Rust ** 宏**,进行 Rust 元编程(  metaprogramming)  的关键所在。而调用一个函数的话,  则要 像这样:`println`(没有`!`)。我们将在 21 章 E 小节中更加详细的讨论 Rust 宏,不过现在你只需记住,当看到符号`!`的时候,就表示调用宏而不是普通 函数。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					接下来,`"Hello, world!"` 是一个 ** 字符串**。我们把这个字符串作为一个参数传递给`println!`,它负责在屏幕上打印这个字符串。轻松加愉快!(⊙o⊙)
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					这一行以一个分号结尾(`;`)。`;`代表这 个表达式的结束和下一个表达式的开始。大部分 Rust 代码行以`;`结尾。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					该行以分号结尾(`;`)。`;`代表一 个表达式的结束和下一个表达式的开始。大部分 Rust 代码行以`;`结尾。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					### 编译和运行是两个步骤
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					在“编写并运行 Rust 程序”部分,展示了如何运行一个新创建的程序。现在我们将拆分并检查每一步操作。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					在运行一个 Rust 程序之前,必须先编译它。可以输入`rustc`命令来使用 Rust 编译器并像这样 传递源文件的名字:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					在运行一个 Rust 程序之前,必须先编译它。可以输入`rustc`命令来使用 Rust 编译器,  并传递源文件的名字给它,如下 : 
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					```
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					$ rustc main.rs
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					```
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					如果你来自  C 或 C++ 背景,就会发现这与`gcc`和`clang`类似。编译成功后,  Rust 应该会输出一个二进制可执行文件,在 Linux 或 OSX 上在 shell 中你可以通过`ls`命令看到如下:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					如果你有  C 或 C++ 背景,就会发现这与`gcc`和`clang`类似。编译成功后,  Rust 应该会输出一个二进制可执行文件,在 Linux 或 OSX 上在 shell 中你可以通过`ls`命令看到如下:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					```
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					$ ls
 
				
			 
			
		
	
	
		
			
				
					
						
						
						
							
								 
							 
						
					 
				
				 
				 
				
					@ -107,7 +107,7 @@ main.exe
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					main.rs
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					```
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					这表示我们有两个文件:*.rs* 后缀的源文件,和可执行文件(在 Windows下是 *main.exe* ,其它平台是 *main* )。这里剩下的操作 就只有运行 *main*  或 *main.exe*  文件了,像这样:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					这表示我们有两个文件:*.rs* 后缀的源文件,和可执行文件(在 Windows下是 *main.exe* ,其它平台是 *main* )。现在需要做的 就只有运行 *main*  或 *main.exe*  文件了,像这样:
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					```
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					$ ./main  # or .\main.exe on Windows
 
				
			 
			
		
	
	
		
			
				
					
						
						
						
							
								 
							 
						
					 
				
				 
				 
				
					@ -115,9 +115,9 @@ $ ./main  # or .\main.exe on Windows
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					如果 *main.rs*  是我们的“Hello, world!”程序,它将会在终端上打印`Hello, world!`。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					来自 Ruby、Python 或 JavaScript 这样的动态类型语言背景的同学,可能不太习惯在分开的步骤编译和执行程序。Rust 是一种 ** 静态提前编译 语言**(  *ahead-of-time compiled language*),这意味着可以 编译好程序后,把它给任何人,他们都 不需要安装 Rust 就可运行。如果你给他们一个 `.rb`  ,   `.py`  或 `.js`  文件,他们需要先分别安装 Ruby,  Python,  JavaScript 实现(  运行时环境,  VM) ,  不过你只需要一句命令就可以编译和执行程序。这一切都是语言设计的权衡取舍。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					来自 Ruby、Python 或 JavaScript 这样的动态类型语言背景的同学,可能不太习惯将编译和执行分为两个步骤。Rust 是一种 ** 预编译静态类型 语言**(  *ahead-of-time compiled language*),这意味着编译好程序后,把它给任何人,他们不需要安装 Rust 就可运行。如果你给他们一个 `.rb`  ,   `.py`  或 `.js`  文件,他们需要先分别安装 Ruby,  Python,  JavaScript 实现(  运行时环境,  VM) ,  不过你只需要一句命令就可以编译和执行程序。这一切都是语言设计的权衡取舍。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					仅仅 使用`rustc`编译简单程序是没问题的,不过随着项目的增长,你将想要能够控制你项目拥有的所有选项 ,并使其易于分享你的代码给别人或别的项目。接下来,我们将介绍一个叫做 Cargo 的工具,它将帮助你编写现实生活 中的 Rust 程序。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					使用  `rustc`  编译简单程序是没问题的,不过随着项目的增长,你将想要能够控制你项目的方方面面 ,并使其易于分享你的代码给别人或别的项目。接下来,我们将介绍一个叫做 Cargo 的工具,它将帮助你编写真实世界 中的 Rust 程序。
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					
 
				
			 
			
		
	
		
			
				
					 
					 
				
				 
				 
				
					## Hello, Cargo!