入门

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

安装 Rust

你可以在 Rust Playground 在线尝试 Rust,无需在你的电脑上安装任何东西。

无需安装即可尝试 Rust

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

安装 Rust 的主要方式是使用一个叫做 Rustup 的工具,它是一个 Rust 安装器和版本管理工具。

看起来你正在运行 macOS、Linux 或其他类 Unix 操作系统。要在终端中下载并安装 Rustup,请运行以下命令,然后按照屏幕上的指示进行操作。如果你使用 Windows,请参见 "其他安装方法"

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

看起来你正在运行 Windows。要开始使用 Rust,请下载安装程序,然后运行程序并按照屏幕上的指示进行操作。你可能需要根据提示安装 Visual Studio C++ Build tools。如果你不使用 Windows,请参见 "其他安装方法"

Linux 的 Windows 子系统

如果你是 Linux 的 Windows 子系统用户,请在终端中运行以下命令,然后按照屏幕上的指示安装 Rust。

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

要安装 Rust,如果你正在运行 Unix 系统,例如 WSL、Linux 或 macOS,
在终端中运行以下命令,然后按照屏幕上的指示进行操作。

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

如果你正在运行 Windows,
下载并运行 rustup‑init.exe,然后按照屏幕上的指示进行操作。


Rust 是最新的吗?

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 中,我们通常将包称为“crate”。

在这个项目中,我们将使用一个名为 ferris-says 的 crate。

在我们的 Cargo.toml 文件中,我们将添加这些信息(这些信息来自 crate 页面):

[dependencies]
ferris-says = "0.3.1"

我们也可以通过运行 cargo add ferris-says 来完成此操作。

现在我们可以运行:

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, width, &mut writer).unwrap();
}

保存后,我们可以通过输入以下命令来运行我们的应用:

cargo run

如果一切顺利,你应该会看到你的应用在屏幕上打印出:

 __________________________
< Hello fellow Rustaceans! >
 --------------------------
        \
         \
            _~^~^~_
        \) /  o o  \ (/
          '_   -   _'
          / '-----' \

了解更多!

你现在是一名 Rustacean 了!欢迎!我们很高兴有你加入。当你准备好时,请访问我们的学习页面,在那里你可以找到许多书籍,它们将帮助你继续你的 Rust 冒险之旅。

了解更多!

这只螃蟹是谁,Ferris?

Ferris 是 Rust 社区的非官方吉祥物。许多 Rust 程序员称自己为“Rustacean”,这是对词语“甲壳动物 (crustacean)”的戏称。我们称呼 Ferris 时可以使用任何代词,“她”、“他”、“他们”、“它”等等。

Ferris 这个名字取自形容词“ferrous”,意为“含铁的”或“与铁有关的”。由于 Rust (生锈) 通常形成于铁上,这似乎是我们吉祥物名字的一个有趣的来源!

你可以在 rustacean.net 上找到更多 Ferris 的图片。 ferris 左右快速移动的 gif 动图