开始使用

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

安装 Rust

你可以在 Rust Playground 中在线尝试 Rust,无需在你的计算机上安装任何东西。

无需安装即可尝试 Rust

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

人们安装 Rust 的主要方式是通过一个名为 Rustup 的工具,它是一个 Rust 安装程序和版本管理工具。

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

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

看起来你正在运行 Windows。要开始使用 Rust,请下载安装程序,然后运行该程序并按照屏幕上的说明进行操作。当提示时,你可能需要安装 Visual Studio C++ 构建工具。如果你不是在 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 中,我们通常将包称为“crates”。

在这个项目中,我们将使用一个名为 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 程序员称自己为“Rustaceans”,这是一个“甲壳纲动物”的文字游戏。我们用任何代词“她”、“他”、“他们”、“它”等来指代 Ferris。

Ferris 的名字来源于形容词“ferrous”,意思是铁的或与铁有关的。由于 Rust 通常在铁上形成,因此这似乎是我们吉祥物名字的一个有趣的起源!

你可以在 rustacean.net 上找到更多 Ferris 的图片。a gif of ferris scurrying side to side