📑 目录

• 前言：为什么 Rust 安装这么多坑？
• 第一步：选择安装方式
• 第二步：Windows 配置
• 第三步：macOS/Linux 配置
• 第四步：验证与配置
• 常见问题排查
• 总结

---

前言：为什么 Rust 安装这么多坑？😫

很多新手第一次安装 Rust 都会遇到：

• ❌ “链接器未找到”
• ❌ “下载速度慢/超时”
• ❌ “Visual Studio 版本不对”
• ❌ “cargo 命令不存在”

别担心！ 这篇文章手把手带你避开所有坑，一次性配置成功！✨

---

第一步：选择安装方式 📥

方式1：rustup（推荐）

# 官方安装工具，支持版本管理
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

方式2：包管理器

# macOS
brew install rust

# Ubuntu/Debian
sudo apt install cargo

# Arch Linux
sudo pacman -S rust

推荐 rustup，原因：

• ✅ 可以切换版本（stable/beta/nightly）
• ✅ 自动配置环境变量
• ✅ 支持交叉编译

---

第二步：Windows 完整配置 🪟

2.1 安装前准备

必需：Visual Studio C++ 构建工具

1. 访问：https://visualstudio.microsoft.com/downloads/
2. 下载 "Build Tools for Visual Studio 2022"
3. 安装时勾选：
   ✅ Desktop development with C++
   ✅ Windows 10/11 SDK

坑点1：不要只安装 Visual Studio Code！需要完整的 C++ 工具链。

2.2 安装 Rust

# 下载 rustup-init.exe
# 访问：https://rustup.rs/

# 运行安装程序
# 选择：1) Proceed with installation (default)

# 等待安装完成...

2.3 配置国内镜像（可选但推荐）

# 设置环境变量
setx RUSTUP_DIST_SERVER "https://rsproxy.cn"
setx RUSTUP_UPDATE_ROOT "https://rsproxy.cn/rustup"

# 配置 cargo 镜像
# 创建文件：%USERPROFILE%\.cargo\config.toml

编辑 config.toml：

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

[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"

[net]
git-fetch-with-cli = true

2.4 验证安装

# 重启终端后执行
rustc --version
cargo --version

# 应该看到类似输出：
# rustc 1.75.0
# cargo 1.75.0

坑点2：如果提示"命令不存在"，手动添加到 PATH：

%USERPROFILE%\.cargo\bin

---

第三步：macOS/Linux 完整配置 🍎🐧

3.1 安装前准备

macOS：

# 安装 Xcode Command Line Tools
xcode-select --install

Linux：

# Ubuntu/Debian
sudo apt update
sudo apt install build-essential

# Fedora/RHEL
sudo dnf install gcc

# Arch
sudo pacman -S base-devel

3.2 安装 Rust

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

# 按提示选择：1) Proceed with installation

坑点3：如果 curl 失败，检查网络或使用代理：

export https_proxy=http://127.0.0.1:7890

3.3 配置国内镜像

编辑 ~/.cargo/config.toml：

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

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

# 或使用 rsproxy
[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"

3.4 配置环境变量

# 添加到 ~/.bashrc 或 ~/.zshrc
source "$HOME/.cargo/env"

# 立即生效
source ~/.bashrc

3.5 验证安装

rustc --version
cargo --version
rustup --version

---

第四步：编辑器配置 🛠️

VS Code（推荐）

安装插件：

1. rust-analyzer（必装）
2. CodeLLDB（调试）
3. Even Better TOML（配置文件）
4. crates（依赖管理）

配置 settings.json：

{
    "rust-analyzer.cargo.allFeatures": true,
    "rust-analyzer.checkOnSave.command": "clippy",
    "editor.formatOnSave": true
}

IntelliJ IDEA

1. 安装 Rust 插件
2. Tools → Rust → Download Rust Sources

---

常见问题排查 🔍

问题1：链接器错误

症状：

error: linker `link.exe` not found

解决：

• Windows：安装 Visual Studio C++ 工具
• Linux：sudo apt install build-essential
• macOS：xcode-select --install

问题2：cargo 安装依赖慢/失败

症状：

Updating crates.io index
timeout...

解决：

# 1. 配置镜像（见上文）

# 2. 或使用代理
export https_proxy=http://127.0.0.1:7890

# 3. 增加超时时间
cargo build --timeout 600

问题3：权限问题

症状：

permission denied

解决：

# Linux/macOS
chmod +x ~/.cargo/bin/*

# 或重新安装到用户目录
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --no-modify-path

问题4：版本冲突

症状：

cargo: incompatible version

解决：

# 卸载旧版本
rustup self uninstall

# 重新安装
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

---

测试你的配置 ✅

创建第一个项目

# 创建项目
cargo new hello_rust
cd hello_rust

# 运行
cargo run

# 应该看到：
# Hello, world!

性能测试

# 编译优化版本
cargo build --release

# 运行测试
cargo test

# 代码检查
cargo clippy

# 代码格式化
cargo fmt

---

完整配置检查清单 📋

Windows：

• Visual Studio C++ 工具
• rustup 安装完成
• 环境变量配置
• 镜像配置（可选）
• VS Code + rust-analyzer

macOS/Linux：

• Xcode/build-essential
• rustup 安装完成
• PATH 配置
• 镜像配置（可选）
• 编辑器插件

验证：

• rustc --version 成功
• cargo new test 成功
• cargo run 成功

---

总结 🎯

三个关键点：

1. Windows 必须安装 C++ 工具链
2. 配置国内镜像提升速度
3. 使用 rust-analyzer 提升体验

---

快速命令参考 📝

# 更新 Rust
rustup update

# 切换版本
rustup default stable
rustup default nightly

# 添加目标平台
rustup target add x86_64-pc-windows-gnu

# 查看已安装工具链
rustup toolchain list

# 文档（离线）
rustup doc --book

---