Rust 是一门以安全性和性能著称的系统级编程语言，适合开发操作系统、游戏引擎和高性能服务。本教程将手把手教你安装 Rust 并配置开发环境，从安装到运行第一个程序，全程无坑！
一、安装 Rust（全平台通用）
1. 通过 rustup 安装（推荐）
rustup 是 Rust 官方工具链管理工具，支持多版本切换和跨平台安装。
Windows/macOS/Linux 通用步骤
打开终端（Windows 使用 PowerShell 或命令提示符），运行以下命令：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
按提示选择安装选项（默认选 1 即可）。安装完成后，运行以下命令使环境变量生效：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 镜像
创建或修改 ~/.cargo/config 文件（Windows 为 C:\Users\用户名\.cargo\config）：mkdir -p ~/.cargo && touch ~/.cargo/config
添加以下内容（以清华大学镜像为例）：[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 官方文档
六、总结
通过本教程，你已成功完成以下操作：
安装 Rust：通过 rustup 实现跨平台一键安装。配置镜像加速：解决国内下载依赖慢的问题。运行首个程序：掌握 Cargo 项目管理工具。
下一步建议：
学习 Rust 所有权和生命周期机制（核心难点）。尝试用 Rust 开发命令行工具（如 clap）。
遇到问题可查阅 Rust 官方文档 或 Rust 中文社区，祝你早日成为 Rust 高手！ 🦀🚀