Rust 是一门以安全性和性能著称的系统级编程语言，适合开发操作系统、游戏引擎和高性能服务。本教程将手把手教你安装 Rust 并配置开发环境，从安装到运行第一个程序，全程无坑！

---

一、安装 Rust（全平台通用）

1. 通过 rustup 安装（推荐）

rustup 是 Rust 官方工具链管理工具，支持多版本切换和跨平台安装。

Windows/macOS/Linux 通用步骤

1. 打开终端（Windows 使用 PowerShell 或命令提示符），运行以下命令：

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

2. 按提示选择安装选项（默认选 1 即可）。
3. 安装完成后，运行以下命令使环境变量生效：

   source "$HOME/.cargo/env"  # macOS/Linux
   # Windows 会自动配置，重启终端即可
   

---

2. 验证安装

rustc --version
# 输出示例：rustc 1.74.0 (79e9716c9 2023-11-13)
cargo --version
# 输出示例：cargo 1.74.0 (ecb9851af 2023-10-18)

---

二、配置国内镜像（加速依赖下载）

1. 配置 crates.io 镜像

1. 创建或修改 ~/.cargo/config 文件（Windows 为 C:\Users\用户名\.cargo\config）：

   mkdir -p ~/.cargo && touch ~/.cargo/config
   

2. 添加以下内容（以清华大学镜像为例）：

   [source.crates-io]
   replace-with = 'tuna'
   
   [source.tuna]
   registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"
   

2. 配置 Rustup 镜像

export RUSTUP_DIST_SERVER="https://mirrors.tuna.tsinghua.edu.cn/rustup"
# 将此命令添加到 ~/.bashrc 或 ~/.zshrc（macOS/Linux）
# Windows 在系统环境变量中添加 RUSTUP_DIST_SERVER

---

三、编写并运行第一个 Rust 程序

1. 使用 Cargo 创建项目

cargo new hello_rust
cd hello_rust

项目结构：

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

2. 编写代码

打开 src/main.rs，输入以下内容：

fn main() {
    println!("你好，世界！");
}

3. 编译并运行

cargo run
# 输出：你好，世界！

---

四、新手容易忽略的细节

1. 未安装必要构建工具

• 现象：编译时报错 linker 'cc' not found。
• 解决：
  • macOS：xcode-select --install（安装 Xcode 命令行工具）。
  • Linux：sudo apt install build-essential（Ubuntu/Debian）。
  • Windows：安装 Visual Studio Build Tools（勾选 “C++ 生成工具”）。

---

2. 环境变量未生效

• 现象：终端提示 rustc 或 cargo 命令不存在。
• 解决：
  • 运行 source "$HOME/.cargo/env"（macOS/Linux）。
  • Windows：检查 Path 是否包含 %USERPROFILE%\.cargo\bin。

---

3. 未更新工具链

• 现象：依赖包要求新版 Rust，但当前版本过低。
• 解决：定期更新 Rust：

  rustup update
  

---

4. 未配置镜像导致下载慢

• 现象：cargo build 下载依赖超时。
• 解决：
  • 确保 ~/.cargo/config 和 Rustup 镜像已正确配置（参考第二节）。
  • 临时指定镜像：

    cargo build --registry crates-io --index https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git
    

---

五、常用命令速查

命令	说明
cargo new 项目名	创建新项目
cargo build	编译项目（生成 target/debug）
cargo run	编译并运行项目
cargo check	检查代码语法（不生成可执行文件）
rustup doc	打开本地 Rust 官方文档

---

六、总结

通过本教程，你已成功完成以下操作：

1. 安装 Rust：通过 rustup 实现跨平台一键安装。
2. 配置镜像加速：解决国内下载依赖慢的问题。
3. 运行首个程序：掌握 Cargo 项目管理工具。

下一步建议：

• 学习 Rust 所有权和生命周期机制（核心难点）。
• 尝试用 Rust 开发命令行工具（如 clap）。

遇到问题可查阅 Rust 官方文档 或 Rust 中文社区，祝你早日成为 Rust 高手！ 🦀🚀