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-04-18 14:55:09 +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-03-19 14:53:41 +08:00
|
|
|
|
<p>现在已经安装好了 Rust，让我们来编写第一个 Rust 程序。当学习一门新语言的时候，编写一个在屏幕上打印 “Hello, world!” 文本的小程序是一个传统，而在这一部分将遵循这个传统。</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<blockquote>
|
|
|
|
|
|
<p>注意：本书假设你熟悉基本的命令行操作。Rust 本身并不对你的编辑器，工具和你的代码存放在何处有什么特定的要求，所以如果你比起命令行更喜欢 IDE，请随意选择你喜欢的 IDE。</p>
|
|
|
|
|
|
</blockquote>
|
2017-02-26 15:11:54 +08:00
|
|
|
|
<a class="header" href="#创建项目文件夹" name="创建项目文件夹"><h3>创建项目文件夹</h3></a>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<p>首先，创建一个文件夹来存放 Rust 代码。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-03-19 14:53:41 +08:00
|
|
|
|
<p>接下来，新建一个叫做 <em>main.rs</em> 的源文件。Rust 文件总是以 <em>.rs</em> 后缀结尾。如果文件名多于一个单词，使用下划线分隔它们。例如，使用 <em>my_program.rs</em> 而不是 <em>myprogram.rs</em>。</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<p>现在打开刚创建的 <em>main.rs</em> 文件，并输入如下代码：</p>
|
|
|
|
|
|
<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>
|
|
|
|
|
|
<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-03-19 14:53:41 +08:00
|
|
|
|
<p>现在，让我们回过头来仔细看看“Hello, world!”程序到底发生了什么。这里是谜题的第一片：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<pre><code class="language-rust">fn main() {
|
|
|
|
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
</code></pre>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<p>这几行定义了一个 Rust <strong>函数</strong>。<code>main</code>函数是特殊的：这是每一个可执行的 Rust 程序首先运行的函数（译者注：入口点）。第一行表示“定义一个叫 <code>main</code> 的函数，没有参数也没有返回值。”如果有参数的话，它们应该出现在括号中，<code>(</code>和<code>)</code>。</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<p>同时注意函数体被包裹在大括号中，<code>{</code>和<code>}</code>。Rust 要求所有函数体都位于大括号中（译者注：对比有些语言特定情况可以省略大括号）。将前一个大括号与函数声明置于一行，并留有一个空格被认为是一个好的代码风格。</p>
|
|
|
|
|
|
<p>在<code>main()</code>函数中：</p>
|
|
|
|
|
|
<pre><code class="language-rust"> println!("Hello, world!");
|
|
|
|
|
|
</code></pre>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<p>这行代码做了这个小程序的所有工作：它在屏幕上打印文本。这里有很多需要注意的细节。第一个是 Rust 代码风格使用 4 个空格缩进，而不是 1 个制表符（tab）。</p>
|
2017-05-15 08:27:11 +08:00
|
|
|
|
<p>第二个重要的部分是<code>println!()</code>。这叫做 Rust <strong>宏</strong>，是如何进行 Rust 元编程（metaprogramming）的关键所在。相反如果是调用一个函数的话，它应该看起来像这样：<code>println</code>（没有<code>!</code>）。我们将在 21 章 E 小节中更加详细的讨论 Rust 宏，不过现在你只需记住当看到符号<code>!</code>的时候，就代表在调用一个宏而不是一个普通的函数。</p>
|
2017-02-14 22:42:54 +08:00
|
|
|
|
<p>接下来，<code>"Hello, world!"</code> 是一个 <strong>字符串</strong>。我们把这个字符串作为一个参数传递给<code>println!</code>，它负责在屏幕上打印这个字符串。轻松加愉快！(⊙o⊙)</p>
|
2017-02-07 12:46:11 +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-02-07 12:46:11 +08:00
|
|
|
|
<p>在“编写并运行 Rust 程序”部分，展示了如何运行一个新创建的程序。现在我们将拆分并检查每一步操作。</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<p>在运行一个 Rust 程序之前，必须先编译它。可以输入<code>rustc</code>命令来使用 Rust 编译器并像这样传递源文件的名字：</p>
|
|
|
|
|
|
<pre><code>$ rustc main.rs
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</code></pre>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<p>如果你来自 C 或 C++ 背景，就会发现这与<code>gcc</code>和<code>clang</code>类似。编译成功后，Rust 应该会输出一个二进制可执行文件，在 Linux 或 OSX 上在 shell 中你可以通过<code>ls</code>命令看到如下：</p>
|
|
|
|
|
|
<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>
|
|
|
|
|
|
<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-02-14 22:42:54 +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>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<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-03-19 14:53:41 +08:00
|
|
|
|
<p>Cargo 是 Rust 的构建系统和包管理工具，同时 Rustacean 们使用 Cargo 来管理他们的 Rust 项目，因为它使得很多任务变得更轻松。例如，Cargo 负责构建代码、下载代码依赖的库并编译这些库。我们把代码需要的库叫做 <strong>依赖</strong>（<em>dependencies</em>）。</p>
|
2017-05-15 08:27:11 +08:00
|
|
|
|
<p>最简单的 Rust 程序，例如我们刚刚编写的，并没有任何依赖，所以目前我们只使用了 Cargo 负责构建代码的那一部分。随着编写更加复杂的 Rust 程序，你会想要添加依赖，如果你使用 Cargo 开始的话，这将会变得简单许多。</p>
|
2017-02-15 23:25:41 +08:00
|
|
|
|
<p>由于绝大部分 Rust 项目使用 Cargo，本书接下来的部分将假设你使用它。如果使用安装章节介绍的官方安装包的话，Rust 自带 Cargo。如果通过其他方式安装 Rust 的话，可以在终端输入如下命令检查是否安装了 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-03-19 14:53:41 +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-03-19 14:53:41 +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-03-19 14:53:41 +08:00
|
|
|
|
<p>我们向<code>cargo new</code>传递了<code>--bin</code>因为我们的目标是生成一个可执行程序，而不是一个库。可执行文件是二进制可执行文件，通常就叫做 <strong>二进制文件</strong>（<em>binaries</em>）。项目的名称被定为<code>hello_cargo</code>，同时 Cargo 在一个同名目录中创建它的文件，接着我们可以进入查看。</p>
|
2017-04-18 14:55:09 +08:00
|
|
|
|
<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> 文件；你可以改为使用不同的版本控制系统（VCS），或者不使用 VCS，通过<code>--vcs</code>参数。</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<p>使用你选择的文本编辑器（IDE）打开 <em>Cargo.toml</em> 文件。它应该看起来像这样：</p>
|
|
|
|
|
|
<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>
|
|
|
|
|
|
<p>这个文件使用<a href="https://github.com/toml-lang/toml"><em>TOML</em></a><!-- ignore --> (Tom's Obvious, Minimal Language) 格式。TOML 类似于 INI，不过有一些额外的改进之处，并且被用作 Cargo 的配置文件的格式。</p>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<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>
|
|
|
|
|
|
<p>Cargo 为你生成了一个“Hello World!”，正如我们之前编写的那个！目前为止我们所见过的之前项目与 Cargo 生成的项目区别有：</p>
|
|
|
|
|
|
<ul>
|
|
|
|
|
|
<li>代码位于 <em>src</em> 目录</li>
|
|
|
|
|
|
<li>项目根目录包含一个 <em>Cargo.toml</em> 配置文件</li>
|
|
|
|
|
|
</ul>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<p>Cargo 期望源文件位于 <em>src</em> 目录，这样将项目根目录留给 README、license 信息、配置文件和其他跟代码无关的文件。这样，Cargo 帮助你保持项目干净整洁。一切井井有条。</p>
|
|
|
|
|
|
<p>如果没有使用 Cargo 开始项目，正如在 <em>hello_world</em> 目录中的项目，可以把它转化为一个使用 Cargo 的项目，通过将代码放入 <em>src</em> 目录并创建一个合适的 <em>Cargo.toml</em>。</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-03-19 14:53:41 +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>
|
|
|
|
|
|
<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>
|
|
|
|
|
|
<p>注意这一次，并没有出现告诉我们 Cargo 正在编译 <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-03-19 14:53:41 +08:00
|
|
|
|
<p>所以现在又出现一些更多的不同：</p>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
<ul>
|
|
|
|
|
|
<li>使用<code>cargo build</code>构建项目（或使用<code>cargo run</code>一步构建并运行），而不是使用<code>rustc</code></li>
|
2017-03-19 14:53:41 +08:00
|
|
|
|
<li>不同于将构建结果放在源码相同目录，Cargo 会将它放到 <em>target/debug</em> 目录中的文件。</li>
|
2017-02-07 12:46:11 +08:00
|
|
|
|
</ul>
|
2017-03-19 14:53:41 +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-03-19 14:53:41 +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-03-19 14:53:41 +08:00
|
|
|
|
<p>对于简单项目， Cargo 并不能比<code>rustc</code>提供更多的价值，不过随着开发的进行终将体现它的价值。对于拥有多个 crate 的复杂项目，让 Cargo 来协调构建将更简单。有了 Cargo，只需运行<code>cargo build</code>，然后一切将有序运行。即便这个项目很简单，现在也它使用了很多之后你的 Rust 程序生涯将会用得上的实用工具。事实上，无形中你可以使用下面的命令开始所有你想要从事的项目：</p>
|
|
|
|
|
|
<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>
|
|
|
|
|
|
<p>注意：如果你想要查看 Cargo 的更多细节，请阅读官方的 <a href="http://doc.crates.io/guide.html">Cargo guide</a>，它覆盖了其所有的功能。</p>
|
|
|
|
|
|
</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>
|
