入门

快速配置 Rust 开发环境并编写一个小应用!

安装 Rust

您可以在 Rust 演练场上在线试用 Rust 而无需在计算机上安装任何东西。

无需安装,直接尝试 Rust

Rustup:Rust安装器和版本管理工具

安装 Rust 的主要方式是通过 Rustup 这一工具,它既是一个 Rust 安装器又是一个版本管理工具。

您似乎正在运行 macOS、Linux 或其它类 Unix 系统。要下载 Rustup 并安装 Rust,请在终端中运行以下命令,然后遵循屏幕上的指示。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

您似乎正在运行 Windows。要安装 Rust,请下载并运行以下程序,然后遵循屏幕上的指示。

Windows 的 Linux 子系统(WSL)

如果您是 Windows 的 Linux 子系统(WSL)用户,要安装 Rust,请在终端中运行以下命令,然后遵循屏幕上的指示。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Rust 可在 Windows、Linux、macOS、FreeBSD 和 NetBSD 上运行。如果您在这些平台上看到了本条信息,请报告一个问题并附上以下内容:

navigator.platform: MacIntel
navigator.appVersion: 5.0 (Macintosh)

报告问题

如果您正在运行 Unix,要安装 Rust,
请在终端中运行以下命令,然后遵循屏幕上的指示。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

如果您正在运行 Windows,
请下载并运行 rustup‑init.exe,然后遵循屏幕上的指示。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

如果您正在运行 Windows,
请下载并运行 rustup‑init.exe,然后遵循屏幕上的指示。


Rustup 是最新的吗?

Rust 的升级非常频繁。如果您安装 Rustup 后已有一段时间,那么很可能您的 Rust 版本已经过时了。运行 rustup update 获取最新版本的 Rust。


了解更多关于安装的细节

Cargo:Rust 的构建工具和包管理器

您在安装 Rustup 时,也会安装 Rust 构建工具和包管理器的最新稳定版,即 Cargo。Cargo 可以做很多事情:

  • cargo build 可以构建项目
  • cargo run 可以运行项目
  • cargo test 可以测试项目
  • cargo doc 可以为项目构建文档
  • cargo publish 可以将库发布到 crates.io

要检查您是否安装了 Rust 和 Cargo,可以在终端中运行:

cargo --version

阅读《Cargo 手册》

其它工具

Rust 支持多种编辑器:

创建新项目

我们将在新的 Rust 开发环境中编写一个小应用。首先用 Cargo 创建一个新项目。在您的终端中执行:

cargo new hello-rust

这会生成一个名为 hello-rust 的新目录,其中包含以下文件:

hello-rust
|- Cargo.toml
|- src
  |- main.rs

Cargo.toml 为 Rust 的清单文件。其中包含了项目的元数据和依赖库。

src/main.rs 为编写应用代码的地方。


cargo new 会生成一个新的“Hello, world!”项目!我们可以进入新创建的目录中,执行下面的命令来运行此程序:

cargo run

您应该会在终端中看到如下内容:

$ cargo run
   Compiling hello-rust v0.1.0 (/Users/ag_dubs/rust/hello-rust)
    Finished dev [unoptimized + debuginfo] target(s) in 1.34s
     Running `target/debug/hello-rust`
Hello, world!

添加依赖

现在我们来为应用添加依赖。您可以在 crates.io,即 Rust 包的仓库中找到所有类别的库。在 Rust 中,我们通常把包称作“crates”。

在本项目中,我们使用了名为 ferris-says 的库。

我们在 Cargo.toml 文件中添加以下信息(从 crate 页面上获取):

[dependencies]
ferris-says = "0.1"

接着运行:

cargo build

…之后 Cargo 就会安装该依赖。

运行此命令会创建一个新文件 Cargo.lock,该文件记录了本地所用依赖库的精确版本。

要使用该依赖库,我们可以打开 main.rs,删除其中所有的内容(它不过是个示例而已),然后在其中添加下面这行代码:

use ferris_says::say;

这样我们就可以使用 ferris-says crate 中导出的 say 函数了。

一个 Rust 小应用

现在我们用新的依赖库编写一个小应用。在 main.rs 中添加以下代码:

use ferris_says::say; // from the previous step
use std::io::{stdout, BufWriter};

fn main() {
    let stdout  = stdout();
    let message = String::from("Hello fellow Rustaceans!");
    let width   = message.chars().count();

    let mut writer = BufWriter::new(stdout.lock());
    say(message.as_bytes(), width, &mut writer).unwrap();
}
    

保存完毕后,我们可以输入以下命令来运行此应用:

cargo run

如果一切正确,您会看到该应用将以下内容打印到了屏幕上:

----------------------------
| Hello fellow Rustaceans! |
----------------------------
              \
               \
                 _~^~^~_
             \) /  o o  \ (/
               '_   -   _'
               / '-----' \
    

了解更多!

您已经是一名 Rustacean 了!欢迎!我们很高兴您的加入!当您准备好后,跳转到学习页面,您可以在那里找到大量的文档,它们可以帮助您继续 Rust 之旅。

了解更多!

这只螃蟹是谁? Ferris ?

Ferris 是 Rust 社区的非官方吉祥物。很多 Rust 程序员自称“Rustaceans”, 它与“crustacean”相似。 我们用 “they” “them” 等代词,而不用带性别的代词来指代 Ferris。

Ferris 与形容词“ferrous”相似,它的含义与铁有关。由于 Rust(锈)通常由铁形成, 因此它算得上是个吉祥物名字的有趣来源。

您可以在 http://rustacean.net/ 上找到更多 Ferris 的图片。 一个横着走的 Ferris 动图