工欲善其事:安装Rust工具链

说实话,学编程这件事,最怕的不是语法难,而是环境装了半天跑不起来。我见过太多新手在安装这一步就放弃了。今天咱们就把Rust的开发环境一次搞定。

Rust的工具链其实就三样东西:rustupcargorustc。你不需要分别下载它们,因为rustup会帮你一次性搞定全部。

一句话总结:装好rustup,就等于装好了整个Rust工具链。

1. 安装rustup

打开你的终端(Windows用户用PowerShell,Mac/Linux用户用默认终端),直接复制下面这行命令:

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

如果你是Windows用户,也可以去官网下载安装包。我个人习惯用命令行,因为后面更新版本也方便。

安装过程中会问你几个选项,直接选默认的 1 就行。等进度条跑完,你会看到类似这样的提示:

Rust is installed now. Great!

嗯,到这里rustup就装好了。接下来验证一下:

rustc --version
# 输出类似:rustc 1.75.0 (e082d1b3f 2024-01-27)

看到版本号了?说明rustc(Rust编译器)已经就位。

小提示:如果提示找不到命令,关掉终端重新打开一次。环境变量需要重新加载。

2. 认识cargo:你的项目管家

cargo是Rust的包管理器和构建工具。你可以把它想象成一个全能管家——帮你创建项目、下载依赖、编译代码、运行测试。

验证cargo是否装好:

cargo --version
# 输出类似:cargo 1.75.0 (1d8b1cd62 2024-01-23)

我们来创建一个新项目试试手感:

cargo new hello_rust
cd hello_rust
cargo run

你会看到终端打印出 Hello, world!。就这么简单,你的第一个Rust程序已经跑起来了。

这里我解释一下cargo的几个常用命令:

命令 作用
cargo new 创建新项目
cargo build 编译项目(生成可执行文件)
cargo run 编译并运行
cargo check 检查代码能否编译(不生成文件,速度更快)
cargo test 运行测试

注意:cargo check比cargo build快很多。我写代码时习惯频繁用check,确认语法没问题了再build。这能省不少时间。

3. 配置VS Code开发环境

编辑器我推荐VS Code,轻量且插件生态好。当然你用其他编辑器也行,但下面这些配置是我亲测好用的。

首先安装VS Code,然后打开扩展面板(快捷键 Ctrl+Shift+X),搜索并安装这几个插件:

  • rust-analyzer —— 核心插件,提供代码补全、跳转、类型提示
  • CodeLLDB —— 调试器支持
  • Even Better TOML —— 让Cargo.toml文件显示更漂亮
  • crates —— 检查依赖版本是否过时

装好之后,打开刚才创建的 hello_rust 项目文件夹。你会看到VS Code自动识别了Rust项目,状态栏右下角出现 RUST 字样。

试试看:把 main.rs 里的代码改成下面这样:

fn main() {
    let name = "Rust";
    println!("你好,{}!", name);
}

保存文件,鼠标悬停在 name 变量上——rust-analyzer会告诉你它的类型是 &str。这就是类型提示,非常方便。

我的习惯:在VS Code里按 Ctrl+` 打开内置终端,直接敲 cargo run。这样不用切窗口,效率高很多。

4. 避坑指南

我曾经在帮同事配置环境时遇到过几个常见问题,这里列出来:

  • 安装卡住不动? 可能是网络问题。试试设置镜像源:export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
  • Windows上提示找不到链接器? 安装Visual Studio Build Tools,或者装一个MinGW。
  • rust-analyzer不工作? 检查VS Code左下角有没有报错,通常重启一下就好了。

重要:不要用系统包管理器(比如apt、brew)直接装Rust。那些版本往往比较旧,用rustup才能保持最新。

5. 本章知识体系

下面这张图帮你理清Rust工具链的关系:

rustup 版本管理工具 rustc 编译器 cargo 包管理器 + 构建工具 rustup doc 离线文档 工作流程 cargo new → 写代码 → cargo check → cargo build → cargo run rustup update # 保持工具链最新

说白了,rustup是总指挥,它负责安装和管理rustc、cargo。你平时打交道最多的其实是cargo——创建项目、编译、运行都靠它。rustc在后台默默工作,你很少需要直接调用它。

好了,环境已经配好。打开终端,敲一句 cargo new my_project,开始你的Rust之旅吧。


专注资料整理