长安的 Rust 入门教程长安的 Rust 入门教程
首页
基础教程
进阶内容
Rust 官网
编程指南
首页
基础教程
进阶内容
Rust 官网
编程指南
  • 基础教程

    • 📚 基础教程
    • 第1章 - 认识 Rust
    • 第2章 - 安装 Rust
    • 第3章 - Hello World
    • 第4章 - 变量与可变性
    • 第5章 - 数据类型
    • /guide/06-functions.html
    • 第7章 - 控制流
    • 第8章 - 所有权
    • 第9章 - 引用与借用
    • 第10章 - 结构体
    • 第11章 - 枚举
    • 第12章 - 模式匹配
    • 第13章 - 错误处理
    • 第14章 - 集合类型
    • 第15章 - 模块系统
  • 实战项目

    • 第16章 - 实战项目:猜数字游戏
    • 第17章 - 实战项目:待办事项 CLI
    • 第18章 - 实战项目:简单 HTTP 服务器

第2章 - 安装 Rust

嗨,朋友!我是长安。

上一章我们了解了 Rust 是什么,现在该动手了!这一章我会手把手教你在电脑上安装 Rust 开发环境。

别担心,整个过程非常简单,跟着我一步一步来就行。

🎯 安装前的准备

Rust 可以在以下操作系统上运行:

  • ✅ Windows(7 或更高版本)
  • ✅ macOS(10.7 Lion 或更高版本)
  • ✅ Linux(几乎所有主流发行版)

你只需要一台能上网的电脑就够了!

🚀 Windows 系统安装

第一步:下载 Rust 安装器

  1. 打开浏览器,访问 Rust 官网:https://www.rust-lang.org/
  2. 点击 "Get Started" 按钮
  3. 下载 rustup-init.exe 文件

长安说

rustup 是 Rust 的安装和版本管理工具,类似于 Python 的 pip 或 Node.js 的 npm。它会帮你自动安装 Rust 编译器、标准库和 Cargo(包管理器)。

第二步:安装 Visual Studio C++ 构建工具

Rust 在 Windows 上需要 C++ 编译工具链,有两种选择:

方法1:安装 Visual Studio Build Tools(推荐)

  1. 访问:https://visualstudio.microsoft.com/visual-cpp-build-tools/
  2. 下载 "Visual Studio Build Tools"
  3. 安装时勾选 "Desktop development with C++"

方法2:如果你已经安装了 Visual Studio

确保安装了 "Desktop development with C++" 工作负载。

第三步:运行 Rust 安装器

  1. 双击运行 rustup-init.exe
  2. 看到命令行界面,直接按 1 然后回车(选择默认安装)
  3. 等待安装完成(可能需要几分钟,取决于网速)
  4. 看到 "Rust is installed now. Great!" 就说明安装成功了!

第四步:验证安装

  1. 打开 PowerShell 或 命令提示符
  2. 输入以下命令:
rustc --version

如果看到类似 rustc 1.75.0 的版本号,恭喜你,安装成功!

再试试:

cargo --version

应该看到 Cargo 的版本号,比如 cargo 1.75.0。

注意

如果提示"命令找不到",重启一下电脑,然后重新打开终端试试。

🍎 macOS 系统安装

第一步:安装 Xcode 命令行工具

打开终端(Terminal),运行:

xcode-select --install

会弹出一个窗口,点击 "Install" 安装开发工具。

第二步:安装 Rust

在终端中运行:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  1. 按 1 选择默认安装
  2. 等待安装完成
  3. 看到 "Rust is installed now. Great!" 就完成了

第三步:配置环境变量

运行:

source $HOME/.cargo/env

或者重新打开一个终端窗口。

第四步:验证安装

rustc --version
cargo --version

看到版本号就说明安装成功了!

🐧 Linux 系统安装

第一步:安装依赖

Ubuntu/Debian:

sudo apt update
sudo apt install build-essential

Fedora/CentOS/RHEL:

sudo dnf install gcc

Arch Linux:

sudo pacman -S base-devel

第二步:安装 Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  1. 按 1 选择默认安装
  2. 等待安装完成

第三步:配置环境变量

source $HOME/.cargo/env

或者重新打开终端。

第四步:验证安装

rustc --version
cargo --version

🛠️ 选择一个代码编辑器

写代码需要一个好用的编辑器。我推荐以下几个:

1. Visual Studio Code(强烈推荐!)

优点:免费、跨平台、插件丰富、智能提示强大

安装步骤:

  1. 下载 VS Code:https://code.visualstudio.com/
  2. 安装完成后,打开 VS Code
  3. 点击左侧的扩展图标(或按 Ctrl+Shift+X)
  4. 搜索并安装 "rust-analyzer" 插件
  5. (可选)安装 "CodeLLDB" 插件用于调试

长安说

rust-analyzer 是 Rust 官方推荐的 IDE 插件,它会提供代码补全、错误提示、跳转定义等功能,非常好用!

2. IntelliJ IDEA + Rust 插件

如果你习惯用 JetBrains 系列的 IDE,可以选择这个。

3. Vim/Neovim 或 Emacs

如果你是高级用户,这些也都有很好的 Rust 支持。

🎉 你的第一个测试

让我们快速测试一下环境是否正常。

创建一个测试项目

打开终端,运行:

cargo new hello_test
cd hello_test

这会创建一个名为 hello_test 的新项目。

查看项目结构

hello_test/
├── Cargo.toml          # 项目配置文件
└── src/
    └── main.rs         # 源代码文件

运行项目

cargo run

你应该看到:

   Compiling hello_test v0.1.0
    Finished dev [unoptimized + debuginfo] target(s) in 2.34s
     Running `target/debug/hello_test`
Hello, world!

恭喜!

如果你看到了 "Hello, world!",说明你的 Rust 开发环境已经完全配置好了!🎉

🔧 常用的 Rustup 命令

rustup 是管理 Rust 版本的工具,这里列几个常用命令:

# 更新 Rust 到最新版本
rustup update

# 查看已安装的工具链
rustup show

# 安装特定版本的 Rust
rustup install stable
rustup install nightly

# 切换默认工具链
rustup default stable

# 卸载 Rust
rustup self uninstall

📚 Cargo 是什么?

Cargo 是 Rust 的包管理器和构建工具,类似于:

  • JavaScript 的 npm
  • Python 的 pip
  • Java 的 Maven

它的主要功能:

  • ✅ 创建新项目
  • ✅ 编译代码
  • ✅ 运行程序
  • ✅ 管理依赖
  • ✅ 运行测试
  • ✅ 生成文档

常用命令:

# 创建新项目
cargo new project_name

# 编译项目(不运行)
cargo build

# 编译并运行
cargo run

# 检查代码(不生成可执行文件,速度更快)
cargo check

# 运行测试
cargo test

# 生成优化后的发布版本
cargo build --release

🌍 配置国内镜像(可选)

如果你在国内,下载依赖可能会比较慢。可以配置国内镜像源。

在用户目录下创建 .cargo/config.toml 文件:

Windows: C:\Users\你的用户名\.cargo\config.toml
macOS/Linux: ~/.cargo/config.toml

内容如下:

[source.crates-io]
replace-with = 'ustc'

[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index"

长安说

这个配置会让 Cargo 从中国科学技术大学的镜像下载依赖,速度会快很多!

💡 小结

在这一章,我们学会了:

  • 在 Windows、macOS 和 Linux 上安装 Rust
  • 安装和配置 VS Code 编辑器
  • 使用 rustup 管理 Rust 版本
  • 使用 cargo 创建和运行项目
  • 配置国内镜像加速下载

🚀 下一步

环境搭建好了,是时候写第一个 Rust 程序了!

下一章,我们会详细了解 "Hello, World!" 程序,理解 Rust 代码的基本结构。

第3章 - Hello World →

💪 练习题

在继续之前,确保你能完成这些操作:

  1. 在终端中运行 rustc --version 和 cargo --version,确认安装成功
  2. 使用 cargo new 创建一个新项目
  3. 使用 cargo run 运行这个项目
  4. 在 VS Code 中打开项目,看看 rust-analyzer 是否正常工作(应该有代码高亮和智能提示)
遇到问题了?

常见问题解决方案:

  1. 命令找不到:重启电脑或重新打开终端
  2. 下载很慢:配置国内镜像源
  3. 编译错误:检查是否安装了 C++ 构建工具(Windows)或开发工具(macOS/Linux)
  4. rust-analyzer 不工作:重启 VS Code,或者重新安装插件
最近更新: 2025/12/26 18:01
Contributors: 王长安
Prev
第1章 - 认识 Rust
Next
第3章 - Hello World