rust语言新手入门贴

入门

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

安装 Rust

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

无需安装，直接尝试 RUST

---

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

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

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

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

了解更多关于安装的细节

---

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

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

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

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

cargo --version

阅读《CARGO 之书》

---

其它工具

Rust 支持多种编辑器：

VS CODE

SUBLIME TEXT 3

ATOM

INTELLIJ IDEA

ECLIPSE

VIM

EMACS

GEANY

您可以用rustup component add rustfmt安装代码格式化工具 Rustfmt，用rustup component add clippy安装 lint 工具 Clippy。

创建新项目

我们将在新的 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-sayscrate 中导出的say函数了。

一个 Rust 小应用

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

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

fn main() {
    let stdout = stdout();
    let out = b"Hello fellow Rustaceans!";
    let width = 24;

    let mut writer = BufWriter::new(stdout.lock());
    say(out, 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 的图片。