Rust: 快速开始

0x01. 安装

在 Rust 开发环境中,所有工具都安装到 ~/.cargo/bin 目录中,您可以在此处找到 Rust 工具链,包括 rustccargorustup

1.1 Windows

  1. Using rustup (Recommended)
  1. Windows Subsystem for Linux
  • curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

1.2 Linux & MacOS

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

0x02. 更新

要更新 Rust,在终端执行以下命令即可更新:

1
rustup update

0x03. 卸载

要卸载 Rust 和 rustup,在终端执行以下命令即可卸载:

1
rustup self uninstall

0x04. 检查安装是否成功

检查是否正确安装了 Rust,可打开终端并输入下面这行,此时能看到最新发布的稳定版本的版本号、提交哈希值和提交日期:

1
2
3
4
5
rustc -V
# rustc 1.83.0 (90b35a623 2024-11-26)

cargo -V
# cargo 1.83.0 (5ffbef321 2024-10-29)

0x05. 切换国内镜像源

由于国内拉取 crates.io 以及安装 Rust 会面临流量出境不稳定的问题,我们提供了一个国内镜像代理以帮助国内 Rust 生态发展,欢迎大家使用。(rsproxy
——字节跳动

5.1 配置说明

步骤一:设置 Rustup 镜像, 修改配置 ~/.zshrc or ~/.bashrc

1
2
export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn/rustup"

步骤二:安装 Rust(请先完成步骤一的环境变量导入并 source rc 文件或重启终端生效)

1
curl --proto '=https' --tlsv1.2 -sSf https://rsproxy.cn/rustup-init.sh | sh

步骤三:设置 crates.io 镜像, 修改配置 ~/.cargo/config,已支持git协议和sparse协议,>=1.68 版本建议使用 sparse-index,速度更快。

1
2
3
4
5
6
7
8
9
10
[source.crates-io]
replace-with = 'rsproxy-sparse'
[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"
[source.rsproxy-sparse]
registry = "sparse+https://rsproxy.cn/index/"
[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"
[net]
git-fetch-with-cli = true

0x06. 本地文档

Rust 的安装还包括文档的本地副本,以便您可以离线阅读。运行 rustup doc 即可在浏览器中打开本地文档。

0x07. 示例

7.1 创建项目目录

1
2
mkdir hello_world
cd hello_world

7.2 编写并运行Rust程序

接下来,创建一个新的源文件并将其命名为 main.rs。Rust 文件始终以 .rs 扩展名结尾。如果文件名中使用多个单词,则惯例是使用下划线将它们分隔开。例如,使用 hello_world.rs 而不是 helloworld.rs

1
2
3
fn main() {
println!("Hello, world!");
}

编译运行

1
2
3
rustc main.rs
./main
# Hello, world!