2017-02-07 12:46:11 +08:00
|
|
|
|
<!DOCTYPE HTML>
|
|
|
|
|
|
<html lang="en">
|
|
|
|
|
|
<head>
|
|
|
|
|
|
<meta charset="UTF-8">
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<title>Hello, World! - Rust 程序设计语言 简体中文版</title>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<meta name="description" content="Rust 程序设计语言 简体中文版">
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
|
|
|
|
|
|
|
|
|
|
<base href="">
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="book.css">
|
|
|
|
|
|
<link href='https://fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800' rel='stylesheet' type='text/css'>
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="shortcut icon" href="favicon.png">
|
|
|
|
|
|
|
|
|
|
|
|
<!-- Font Awesome -->
|
|
|
|
|
|
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.3.0/css/font-awesome.min.css">
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="highlight.css">
|
|
|
|
|
|
<link rel="stylesheet" href="tomorrow-night.css">
|
|
|
|
|
|
|
|
|
|
|
|
<!-- MathJax -->
|
|
|
|
|
|
<script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- Fetch JQuery from CDN but have a local fallback -->
|
|
|
|
|
|
<script src="https://code.jquery.com/jquery-2.1.4.min.js"></script>
|
|
|
|
|
|
<script>
|
|
|
|
|
|
if (typeof jQuery == 'undefined') {
|
|
|
|
|
|
document.write(unescape("%3Cscript src='jquery.js'%3E%3C/script%3E"));
|
|
|
|
|
|
}
|
|
|
|
|
|
</script>
|
|
|
|
|
|
</head>
|
|
|
|
|
|
<body class="light">
|
|
|
|
|
|
<!-- Set the theme before any content is loaded, prevents flash -->
|
|
|
|
|
|
<script type="text/javascript">
|
|
|
|
|
|
var theme = localStorage.getItem('theme');
|
|
|
|
|
|
if (theme == null) { theme = 'light'; }
|
|
|
|
|
|
$('body').removeClass().addClass(theme);
|
|
|
|
|
|
</script>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- Hide / unhide sidebar before it is displayed -->
|
|
|
|
|
|
<script type="text/javascript">
|
|
|
|
|
|
var sidebar = localStorage.getItem('sidebar');
|
|
|
|
|
|
if (sidebar === "hidden") { $("html").addClass("sidebar-hidden") }
|
|
|
|
|
|
else if (sidebar === "visible") { $("html").addClass("sidebar-visible") }
|
|
|
|
|
|
</script>
|
|
|
|
|
|
|
|
|
|
|
|
<div id="sidebar" class="sidebar">
|
2017-05-31 23:48:57 +08:00
|
|
|
|
<ul class="chapter"><li><a href="ch01-00-introduction.html"><strong>1.</strong> 介绍</a></li><li><ul class="section"><li><a href="ch01-01-installation.html"><strong>1.1.</strong> 安装</a></li><li><a href="ch01-02-hello-world.html" class="active"><strong>1.2.</strong> Hello, World!</a></li></ul></li><li><a href="ch02-00-guessing-game-tutorial.html"><strong>2.</strong> 猜猜看教程</a></li><li><a href="ch03-00-common-programming-concepts.html"><strong>3.</strong> 通用编程概念</a></li><li><ul class="section"><li><a href="ch03-01-variables-and-mutability.html"><strong>3.1.</strong> 变量和可变性</a></li><li><a href="ch03-02-data-types.html"><strong>3.2.</strong> 数据类型</a></li><li><a href="ch03-03-how-functions-work.html"><strong>3.3.</strong> 函数如何工作</a></li><li><a href="ch03-04-comments.html"><strong>3.4.</strong> 注释</a></li><li><a href="ch03-05-control-flow.html"><strong>3.5.</strong> 控制流</a></li></ul></li><li><a href="ch04-00-understanding-ownership.html"><strong>4.</strong> 认识所有权</a></li><li><ul class="section"><li><a href="ch04-01-what-is-ownership.html"><strong>4.1.</strong> 什么是所有权</a></li><li><a href="ch04-02-references-and-borrowing.html"><strong>4.2.</strong> 引用 & 借用</a></li><li><a href="ch04-03-slices.html"><strong>4.3.</strong> Slices</a></li></ul></li><li><a href="ch05-00-structs.html"><strong>5.</strong> 结构体</a></li><li><ul class="section"><li><a href="ch05-01-method-syntax.html"><strong>5.1.</strong> 方法语法</a></li></ul></li><li><a href="ch06-00-enums.html"><strong>6.</strong> 枚举和模式匹配</a></li><li><ul class="section"><li><a href="ch06-01-defining-an-enum.html"><strong>6.1.</strong> 定义枚举</a></li><li><a href="ch06-02-match.html"><strong>6.2.</strong> <code>match</code>控制流运算符</a></li><li><a href="ch06-03-if-let.html"><strong>6.3.</strong> <code>if let</code>简单控制流</a></li></ul></li><li><a href="ch07-00-modules.html"><strong>7.</strong> 模块</a></li><li><ul class="section"><li><a href="ch07-01-mod-and-the-filesystem.html"><strong>7.1.</strong> <code>mod</code>和文件系统</a></li><li><a href="ch07-02-controlling-visibility-with-pub.html"><strong>7.2.</strong> 使用<code>pub</code>控制可见性</a></li><li><a href="ch07-03-importing-names-with-use.html"><strong>7.3.</strong> 使用<code>use</code>导入命名</a></li></ul></li><li><a href="ch08-00-common-collections.html"><strong>8.</strong> 通用集合类型</a></li><li><ul class="section"><li><a href="ch08-01-vectors.html"><strong>8.1.</strong> vector</a></li><li><a href="ch08-02-strings.html"><strong>8.2.</strong> 字符串</a></li><li><a href="ch08-03-hash-maps.html"><strong>8.3.</strong> 哈希 map</a></li></ul></li><li><a href="ch09-00-error-handling.html"><strong>9.</strong> 错误处理</a></li><li><ul class="section"><li><a href="ch09-01-unrecoverable-errors-with-panic.html"><strong>9.1.</strong> <code>panic!</code>与不可恢复的错误</a></li><li><a href="ch09-02-recoverable-errors-with-result.html"><strong>9.2.</strong> <code>Result</code>与可恢复的错误</a></li><li><a href="ch09-03-to-panic-or-not-to-panic.html"><strong>9.3.</strong> <code>panic!</code>还是不<code>panic!</code></a></li></ul></li><li><a href="ch10-00-generics.html"><strong>10.</strong> 泛型、trait 和生命周期</a></li><li><ul class="section"><li><a href="ch10-01-syntax.html"><strong>10.1.</strong> 泛型数据类型</a></li><li><a href="ch10-02-traits.html"><strong>10.2.</strong> trait：定义共享的行为</a></li><li><a href="ch10-03-lifetime-syntax.html"><strong>10.3.</strong> 生命周期与引用有效性</a></li></ul></li><li><a href="ch11-00-testing.html"><strong>11.</strong> 测试</a></li><li><ul class="section"><li><a href="ch11-01-writing-tests.html"><strong>11.1.</strong> 编写测试</a></li><li><a href="ch11-02-running-tests.html"><strong>11.2.</strong> 运行测试</a></li><li><a href="ch11-03-test-organization.html"><strong>11.3.</strong> 测试的组织结构</a></li></ul></li><li><a href="ch12-00-
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div id="page-wrapper" class="page-wrapper">
|
|
|
|
|
|
|
|
|
|
|
|
<div class="page">
|
|
|
|
|
|
<div id="menu-bar" class="menu-bar">
|
|
|
|
|
|
<div class="left-buttons">
|
|
|
|
|
|
<i id="sidebar-toggle" class="fa fa-bars"></i>
|
|
|
|
|
|
<i id="theme-toggle" class="fa fa-paint-brush"></i>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<h1 class="menu-title">Rust 程序设计语言 简体中文版</h1>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
|
|
|
|
|
|
<div class="right-buttons">
|
|
|
|
|
|
<i id="print-button" class="fa fa-print" title="Print this book"></i>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div id="content" class="content">
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#hello-world" name="hello-world"><h2>Hello, World!</h2></a>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<blockquote>
|
2017-03-09 23:53:47 +08:00
|
|
|
|
<p><a href="https://github.com/rust-lang/book/blob/master/second-edition/src/ch01-02-hello-world.md">ch01-02-hello-world.md</a>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<br>
|
2017-03-09 23:53:47 +08:00
|
|
|
|
commit 4f2dc564851dc04b271a2260c834643dfd86c724</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</blockquote>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>Rust 已安好，让我们来编写第一个程序。当学习一门新语言的时候，使用该语言在屏幕上打印 “Hello, world!” 是一项传统，我们将遵循这个传统。</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<blockquote>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>注意：本书假设你熟悉基本的命令行操作。对于你的编辑器、工具，以及你的代码存在何处，Rust 并没有特殊要求，如果你更喜欢 IDE，请随意。</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</blockquote>
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#创建项目文件夹" name="创建项目文件夹"><h3>创建项目文件夹</h3></a>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>首先，创建一个存放代码的文件夹。Rust 并不关心它的位置，不过在本书中，我们建议你在 home 目录中创建一个 <em>projects</em> 目录，并把你的所有项目放在这。打开一个终端，输入如下命令来创建一个文件夹：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<p>Linux 和 Mac:</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ mkdir ~/projects
|
2017-02-07 12:46:11 +08:00
|
|
|
|
$ cd ~/projects
|
|
|
|
|
|
$ mkdir hello_world
|
|
|
|
|
|
$ cd hello_world
|
|
|
|
|
|
</code></pre>
|
|
|
|
|
|
<p>Windows:</p>
|
|
|
|
|
|
<pre><code class="language-cmd">> mkdir %USERPROFILE%\projects
|
|
|
|
|
|
> cd %USERPROFILE%\projects
|
|
|
|
|
|
> mkdir hello_world
|
|
|
|
|
|
> cd hello_world
|
|
|
|
|
|
</code></pre>
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#编写并运行-rust-程序" name="编写并运行-rust-程序"><h3>编写并运行 Rust 程序</h3></a>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>接下来，新建一个叫做 <em>main.rs</em> 的文件。Rust 源代码总是以 <em>.rs</em> 后缀结尾。如果文件名包含多个单词，使用下划线分隔它们。例如 <em>my_program.rs</em>，而不是 <em>myprogram.rs</em>。</p>
|
|
|
|
|
|
<p>现在打开刚创建的 <em>main.rs</em> 文件，输入如下代码：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<p><span class="filename">Filename: main.rs</span></p>
|
|
|
|
|
|
<pre><code class="language-rust">fn main() {
|
|
|
|
|
|
println!("Hello, world!");
|
|
|
|
|
|
}
|
|
|
|
|
|
</code></pre>
|
|
|
|
|
|
<p>保存文件，并回到终端窗口。在 Linux 或 OSX 上，输入如下命令：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ rustc main.rs
|
2017-02-07 12:46:11 +08:00
|
|
|
|
$ ./main
|
|
|
|
|
|
Hello, world!
|
|
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>在 Windows 上，运行 <code>.\main.exe</code>，而不是<code>./main</code>。不管使用何种系统，你应该在终端看到 <code>Hello, world!</code> 字样。如果你做到了，恭喜你！你已经正式编写了一个 Rust 程序，成为一名 Rust 程序员！</p>
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#分析-rust-程序" name="分析-rust-程序"><h3>分析 Rust 程序</h3></a>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>现在，让我们回过头来，仔细看看“Hello, world!”程序到底发生了什么。这是拼图的第一片：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<pre><code class="language-rust">fn main() {
|
|
|
|
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>这几行定义了一个 Rust <strong>函数</strong>。一个叫 <code>main</code> 的函数，没有参数也没有返回值。如果有参数的话，它们应该出现在括弧中，<code>(</code>和<code>)</code>之间。<code>main</code> 函数是特殊的：它是每一个可执行的 Rust 程序的入口点。</p>
|
|
|
|
|
|
<p>还须注意函数体被包裹在花括号中，<code>{</code>和<code>}</code> 之间。所有函数体都要用花括号包裹起来（译者注：有些语言，当函数体只有一行时可以省略花括号，但 Rust 中是不行的）。一般来说，将左花括号与函数声明置于一行，并以空格分隔，是良好的代码风格。</p>
|
|
|
|
|
|
<p>在 <code>main()</code> 函数中：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<pre><code class="language-rust"> println!("Hello, world!");
|
|
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>一行代码完成这个小程序的所有工作：在屏幕上打印文本。这里有很多细节需要注意。首先 Rust 使用 4 个空格的缩进风格，而不是 1 个制表符（tab）。</p>
|
|
|
|
|
|
<p>第二个重要的部分是<code>println!()</code>。这是 <strong>宏</strong>，Rust 元编程（metaprogramming）的关键所在。而调用一个函数，则要像这样：<code>println</code>（没有<code>!</code>）。我们将在 21 章 E 小节中更加详细的讨论宏，现在你只需记住，当看到符号 <code>!</code> 的时候，调用的是宏而不是普通函数。</p>
|
2017-02-14 22:42:54 +08:00
|
|
|
|
<p>接下来，<code>"Hello, world!"</code> 是一个 <strong>字符串</strong>。我们把这个字符串作为一个参数传递给<code>println!</code>，它负责在屏幕上打印这个字符串。轻松加愉快！(⊙o⊙)</p>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>该行以分号结尾（<code>;</code>）。<code>;</code> 代表一个表达式的结束和下一个表达式的开始。大部分 Rust 代码行以 <code>;</code> 结尾。</p>
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#编译和运行是两个步骤" name="编译和运行是两个步骤"><h3>编译和运行是两个步骤</h3></a>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>“编写并运行 Rust 程序”部分，展示了如何创建运行程序。现在我们将拆分并检查每一步操作。</p>
|
|
|
|
|
|
<p>运行一个 Rust 程序之前，必须先编译它。可以通过 <code>rustc</code> 命令来使用 Rust 编译器，并传递源文件的名字给它，如下：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ rustc main.rs
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>如果你有 C 或 C++ 背景，就会发现这与 <code>gcc</code> 和 <code>clang</code> 类似。编译成功后，Rust 应该会输出一个二进制可执行文件，在 Linux 或 OSX 上在 shell 中你可以通过<code>ls</code>命令看到如下：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ ls
|
2017-02-07 12:46:11 +08:00
|
|
|
|
main main.rs
|
|
|
|
|
|
</code></pre>
|
|
|
|
|
|
<p>在 Windows 上，输入：</p>
|
|
|
|
|
|
<pre><code class="language-cmd">> dir /B %= the /B option says to only show the file names =%
|
|
|
|
|
|
main.exe
|
|
|
|
|
|
main.rs
|
|
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>这表示我们有两个文件：<em>.rs</em> 后缀的源文件，和可执行文件（在 Windows下是 <em>main.exe</em>，其它平台是 <em>main</em>）。然后运行 <em>main</em> 或 <em>main.exe</em> 文件，像这样：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ ./main # or .\main.exe on Windows
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</code></pre>
|
|
|
|
|
|
<p>如果 <em>main.rs</em> 是我们的“Hello, world!”程序，它将会在终端上打印<code>Hello, world!</code>。</p>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>来自 Ruby、Python 或 JavaScript 这样的动态类型语言背景的同学，可能不太习惯将编译和执行分为两个步骤。Rust 是一种 <strong>预编译静态类型语言</strong>（<em>ahead-of-time compiled language</em>），这意味着编译好程序后，把它给任何人，他们不需要安装 Rust 就可运行。如果你给他们一个 <code>.rb</code> ， <code>.py</code> 或 <code>.js</code> 文件，他们需要先分别安装 Ruby，Python，JavaScript 实现（运行时环境，VM），不过你只需要一句命令就可以编译和执行程序。这一切都是语言设计上的权衡取舍。</p>
|
|
|
|
|
|
<p>使用 <code>rustc</code> 编译简单程序是没问题的，不过随着项目的增长，你可能需要控制你项目的方方面面，并且更容易地将代码分享给其它人或项目。所以接下来，我们要介绍一个叫做 Cargo 的工具，它会帮助你编写真实世界中的 Rust 程序。</p>
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#hello-cargo" name="hello-cargo"><h2>Hello, Cargo!</h2></a>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>Cargo 是 Rust 的构建系统和包管理工具，同时 Rustacean 们使用 Cargo 来管理他们的 Rust 项目，它使得很多任务变得更轻松。例如，Cargo 负责构建代码、下载依赖库并编译。我们把代码需要的库叫做 <strong>依赖</strong>（<em>dependencies</em>）。</p>
|
|
|
|
|
|
<p>最简单的 Rust 程序，比如我们刚刚编写的，并没有任何依赖，所以我们只使用了 Cargo 构建代码的功能。随着更复杂程序的编写，你会想要添加依赖，如果你使用 Cargo 开始的话，这将会变得简单许多。</p>
|
|
|
|
|
|
<p>由于绝大部分 Rust 项目使用 Cargo，本书接下来的部分将假设你使用它。如果使用之前介绍的官方安装包的话，它自带 Cargo。如果通过其他方式安装的话，可以在终端输入如下命令，检查是否安装了 Cargo：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ cargo --version
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>如果出现了版本号，一切 OK！如果出现类似“<code>command not found</code>”的错误，你应该查看安装文档以确定如何单独安装 Cargo。</p>
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#使用-cargo-创建项目" name="使用-cargo-创建项目"><h3>使用 Cargo 创建项目</h3></a>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>让我们使用 Cargo 来创建一个新项目，然后看看与上面的<code>hello_world</code>项目有什么不同。回到 projects 目录（或者任何你放置代码的目录）：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<p>Linux 和 Mac:</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ cd ~/projects
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</code></pre>
|
|
|
|
|
|
<p>Windows:</p>
|
|
|
|
|
|
<pre><code class="language-cmd">> cd %USERPROFILE%\projects
|
|
|
|
|
|
</code></pre>
|
|
|
|
|
|
<p>并在任何操作系统运行：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ cargo new hello_cargo --bin
|
2017-02-07 12:46:11 +08:00
|
|
|
|
$ cd hello_cargo
|
|
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>我们向 <code>cargo new</code> 传递了 <code>--bin</code>，因为我们的目标是生成一个可执行程序，而不是一个库。可执行程序是二进制可执行文件，通常就叫做 <strong>二进制文件</strong>（<em>binaries</em>）。项目的名称被定为<code>hello_cargo</code>，同时 Cargo 在一个同名目录中创建它的文件，接着我们可以进入查看。</p>
|
|
|
|
|
|
<p>如果列出 <em>hello_cargo</em> 目录中的文件，将会看到 Cargo 生成了一个文件和一个目录：一个 <em>Cargo.toml</em> 文件和一个 <em>src</em> 目录，<em>main.rs</em> 文件位于目录中。它也在 <em>hello_cargo</em> 目录初始化了一个 git 仓库，以及一个 <em>.gitignore</em> 文件；你可以通过<code>--vcs</code>参数，切换到其它版本控制系统（VCS），或者不使用 VCS。</p>
|
|
|
|
|
|
<p>使用文本编辑器（IDE）打开 <em>Cargo.toml</em> 文件。它应该看起来像这样：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<p><span class="filename">Filename: Cargo.toml</span></p>
|
|
|
|
|
|
<pre><code class="language-toml">[package]
|
|
|
|
|
|
name = "hello_cargo"
|
|
|
|
|
|
version = "0.1.0"
|
|
|
|
|
|
authors = ["Your Name <you@example.com>"]
|
|
|
|
|
|
|
|
|
|
|
|
[dependencies]
|
|
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>这个文件使用 <a href="https://github.com/toml-lang/toml"><em>TOML</em></a><!-- ignore --> (Tom's Obvious, Minimal Language) 格式。TOML 类似于 INI，不过有一些额外的改进之处，并且被用作 Cargo 的配置文件的格式。</p>
|
|
|
|
|
|
<p>第一行，<code>[package]</code>，是一个段落标题，表明下面的语句用来配置一个包。随着我们在这个文件增加更多的信息，还将增加其他段落。</p>
|
|
|
|
|
|
<p>最后一行，<code>[dependencies]</code>，是项目依赖的 <em>crates</em>（Rust 代码包）的段落的开始，这样 Cargo 就知道下载和编译它们了。这个项目并不需要任何其他的 crate，不过在下一章猜猜看教程会需要。</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<p>现在看看 <em>src/main.rs</em>：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<p><span class="filename">Filename: src/main.rs</span></p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<pre><code class="language-rust">fn main() {
|
|
|
|
|
|
println!("Hello, world!");
|
|
|
|
|
|
}
|
|
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>Cargo 为你生成了一个“Hello World!”，正如我们之前编写的那个！目前为止，之前项目与 Cargo 生成项目区别有：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<ul>
|
|
|
|
|
|
<li>代码位于 <em>src</em> 目录</li>
|
|
|
|
|
|
<li>项目根目录包含一个 <em>Cargo.toml</em> 配置文件</li>
|
|
|
|
|
|
</ul>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>Cargo 期望源文件位于 <em>src</em> 目录，将项目根目录留给 README、license 信息、配置文件和其他跟代码无关的文件。这样，Cargo 帮助你保持项目干净整洁，一切井井有条。</p>
|
|
|
|
|
|
<p>如果没有用 Cargo 创建项目，比如 <em>hello_world</em> 目录中的项目，可以通过将代码放入 <em>src</em> 目录，并创建一个合适的 <em>Cargo.toml</em>，将其转化为一个 Cargo 项目。</p>
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#构建并运行-cargo-项目" name="构建并运行-cargo-项目"><h3>构建并运行 Cargo 项目</h3></a>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<p>现在让我们看看通过 Cargo 构建和运行 Hello World 程序有什么不同。为此，输入如下命令：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<pre><code>$ cargo build
|
|
|
|
|
|
Compiling hello_cargo v0.1.0 (file:///projects/hello_cargo)
|
|
|
|
|
|
</code></pre>
|
|
|
|
|
|
<p>这应该创建 <em>target/debug/hello_cargo</em>（或者在 Windows 上是 <em>target\debug\hello_cargo.exe</em>）可执行文件，可以通过这个命令运行：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ ./target/debug/hello_cargo # or .\target\debug\hello_cargo.exe on Windows
|
2017-02-07 12:46:11 +08:00
|
|
|
|
Hello, world!
|
|
|
|
|
|
</code></pre>
|
|
|
|
|
|
<p>好的！如果一切顺利，<code>Hello, world!</code>应该再次打印在终端上。</p>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>首次运行 <code>cargo build</code> 的时候，Cargo 会在项目根目录创建一个新文件，<em>Cargo.lock</em>，它看起来像这样：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<p><span class="filename">Filename: Cargo.lock</span></p>
|
|
|
|
|
|
<pre><code class="language-toml">[root]
|
|
|
|
|
|
name = "hello_cargo"
|
|
|
|
|
|
version = "0.1.0"
|
|
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>Cargo 使用 <em>Cargo.lock</em> 来记录程序的依赖。这个项目并没有依赖，所以内容比较少。事实上，你自己永远也不需要碰这个文件，让 Cargo 处理它就行了。</p>
|
|
|
|
|
|
<p>我们刚刚使用 <code>cargo build</code> 构建了项目并使用 <code>./target/debug/hello_cargo</code> 运行了它，也可以使用 <code>cargo run</code> 编译并运行：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ cargo run
|
2017-02-07 12:46:11 +08:00
|
|
|
|
Running `target/debug/hello_cargo`
|
|
|
|
|
|
Hello, world!
|
|
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>注意这一次并没有出现“正在编译 <code>hello_cargo</code>”的输出。Cargo 发现文件并没有被改变，直接运行了二进制文件。如果修改了源文件的话，将会出现像这样的输出：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ cargo run
|
2017-02-07 12:46:11 +08:00
|
|
|
|
Compiling hello_cargo v0.1.0 (file:///projects/hello_cargo)
|
|
|
|
|
|
Running `target/debug/hello_cargo`
|
|
|
|
|
|
Hello, world!
|
|
|
|
|
|
</code></pre>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>所以现在又出现更多的不同：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<ul>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<li>使用 <code>cargo build</code> 构建项目（或使用 <code>cargo run</code> 一步构建并运行），而不是使用<code>rustc</code></li>
|
|
|
|
|
|
<li>有别于将构建结果放在源码目录，Cargo 将它放到 <em>target/debug</em> 目录。</li>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</ul>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>Cargo 的另一个优点是，不管你使用什么操作系统，它的命令都是一样的，所以之后我们将不再为 Linux 和 Mac 以及 Windows 提供相应的命令。</p>
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#发布构建" name="发布构建"><h3>发布构建</h3></a>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>当项目最终准备好发布了，可以使用 <code>cargo build --release</code> 来优化编译项目。这会在 <em>target/release</em> 下生成可执行文件，而不是 <em>target/debug</em>。优化可以让 Rust 代码运行的更快，然而也需要更长的编译时间。因此产生了两种不同的配置：一种为了开发，你需要快速重新构建；另一种构建给用户的最终程序，不会重新构建，并且程序运行得越快越好。如果你在测试代码的运行时间，请确保运行 <code>cargo build --release</code> 并使用 <em>target/release</em> 下的可执行文件。</p>
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#把-cargo-当作习惯" name="把-cargo-当作习惯"><h3>把 Cargo 当作习惯</h3></a>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>对于简单项目， Cargo 并不比 <code>rustc</code> 更有价值，不过随着开发的进行终将体现它的价值。对于拥有多个 crate 的复杂项目，让 Cargo 来协调构建将更简单。有了 Cargo，只需运行<code>cargo build</code>，然后一切将有序运行。即便这个项目很简单，也它使用了很多你之后的 Rust 生涯将会用得上的实用工具。其实你可以开始任何你想要从事的项目，使用下面的命令：</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<pre><code>$ git clone someurl.com/someproject
|
2017-02-07 12:46:11 +08:00
|
|
|
|
$ cd someproject
|
2017-03-19 14:53:41 +08:00
|
|
|
|
$ cargo build
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</code></pre>
|
|
|
|
|
|
<blockquote>
|
2017-05-29 23:49:32 +08:00
|
|
|
|
<p>注意：如果想要了解 Cargo 更多的细节，请阅读官方的 <a href="http://doc.crates.io/guide.html">Cargo guide</a>，它覆盖了所有的功能。</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</blockquote>
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- Mobile navigation buttons -->
|
|
|
|
|
|
|
|
|
|
|
|
<a href="ch01-01-installation.html" class="mobile-nav-chapters previous">
|
|
|
|
|
|
<i class="fa fa-angle-left"></i>
|
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2017-02-11 14:49:51 +08:00
|
|
|
|
<a href="ch02-00-guessing-game-tutorial.html" class="mobile-nav-chapters next">
|
|
|
|
|
|
<i class="fa fa-angle-right"></i>
|
|
|
|
|
|
</a>
|
|
|
|
|
|
|
2017-02-07 12:46:11 +08:00
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<a href="ch01-01-installation.html" class="nav-chapters previous" title="You can navigate through the chapters using the arrow keys">
|
|
|
|
|
|
<i class="fa fa-angle-left"></i>
|
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2017-02-11 14:49:51 +08:00
|
|
|
|
<a href="ch02-00-guessing-game-tutorial.html" class="nav-chapters next" title="You can navigate through the chapters using the arrow keys">
|
|
|
|
|
|
<i class="fa fa-angle-right"></i>
|
|
|
|
|
|
</a>
|
|
|
|
|
|
|
2017-02-07 12:46:11 +08:00
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- Local fallback for Font Awesome -->
|
|
|
|
|
|
<script>
|
|
|
|
|
|
if ($(".fa").css("font-family") !== "FontAwesome") {
|
|
|
|
|
|
$('<link rel="stylesheet" type="text/css" href="_FontAwesome/css/font-awesome.css">').prependTo('head');
|
|
|
|
|
|
}
|
|
|
|
|
|
</script>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- Livereload script (if served using the cli tool) -->
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<script src="highlight.js"></script>
|
|
|
|
|
|
<script src="book.js"></script>
|
|
|
|
|
|
</body>
|
|
|
|
|
|
</html>
|
