📚 Rust 开发环境下载安装教程

（适配 Windows/macOS/Linux，附 Word 排版指南）

一、📄 文档说明

二、📋 目录

1. 📄 文档说明
2. 🛠️ 前置准备
3. 🖥️ 分系统安装步骤（Windows/ macOS/ Linux）
4. ✅ 安装验证方法
5. 💡 Rust 基础使用技巧
6. 🚀 国内用户加速建议
7. ❓ 常见问题与解决方法
8. 💾 本地 Word 排版与保存步骤

三、🛠️ 前置准备

1. 硬件要求

• 内存：≥4GB（编译大型项目需更高配置）
• 硬盘：≥10GB 剩余空间（存储工具链、项目文件）
• 系统：Windows 7+ / macOS 10.12+ / Linux（Ubuntu 16.04+/Fedora 24+）

2. 软件依赖（必装！否则编译失败）

3. 网络环境

• 需稳定网络（国内用户优先配置镜像加速，见「六、🚀 国内用户加速建议」）

四、🖥️ 分系统安装步骤

（一）Windows 系统（🪟 Windows 7+，64位推荐）

1️⃣ 步骤1：安装 Visual Studio 构建工具（必做！）

Rust 编译依赖 Windows 链接器，需单独安装组件：

1. 打开浏览器，访问 Visual Studio 安装器下载页；
2. 运行安装器，仅勾选「使用 C++ 的桌面开发」（无需安装完整 VS，默认包含「MSVC 生成工具」和「Windows SDK」）；
3. 点击「安装」，等待下载完成（约 300-500MB，视网络速度）。

2️⃣ 步骤2：下载 rustup 安装程序

1. 访问 Rust 官网：https://www.rust-lang.org/tools/install；
2. 点击「Download rustup-init.exe (64-bit)」（文件约 1MB，秒下）。

3️⃣ 步骤3：运行安装程序并配置

1. 双击 rustup-init.exe，弹出命令行窗口（提示「用户账户控制」时点击「允许」）；
2. 命令行显示选项：1) 继续默认安装（推荐） 2) 自定义安装 3) 取消安装，直接按 Enter 键；
3. 等待安装（自动下载 Rust 稳定版、cargo，约 5-10 分钟）。

4️⃣ 步骤4：重启命令行（必做！）

关闭所有已打开的「命令提示符（CMD）」或「PowerShell」，重新打开（确保环境变量生效）。

（二）macOS 系统（🍎 macOS 10.12+）

1️⃣ 步骤1：安装 Xcode 命令行工具

1. 打开「终端」：通过「启动台 → 其他 → 终端」找到；
2. 输入以下命令，按 Enter 键：
   💻 xcode-select --install
3. 弹出提示框，点击「安装」，等待完成（约 400MB）。

2️⃣ 步骤2：安装 rustup

1. 在终端输入官方安装命令，按 Enter 键：
   💻 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
2. 提示选项时，输入 1 并按 Enter（默认安装）；
3. 等待安装完成（自动配置环境）。

3️⃣ 步骤3：生效环境变量

1. 输入以下命令加载变量：
   💻 source $HOME/.cargo/env
2. 或直接重启终端（变量会自动生效）。

（三）Linux 系统（🐧 Ubuntu 16.04+/Fedora 24+）

1️⃣ 步骤1：安装系统依赖

1. 打开终端（快捷键：Ctrl+Alt+T）；
2. 根据系统输入命令（需输入用户密码，输入时不显示字符）：
   • Ubuntu/Debian 系列：💻 sudo apt update && sudo apt install build-essential -y
   • Fedora/RHEL 系列：💻 sudo dnf install gcc -y

2️⃣ 步骤2：安装 rustup

1. 输入官方命令，按 Enter 键：
   💻 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
2. 输入 1 选择默认安装，等待完成。

3️⃣ 步骤3：生效环境变量

1. 输入命令加载：
   💻 source $HOME/.cargo/env
2. 或重启终端。

五、✅ 安装验证方法

无论哪个系统，安装后必须验证环境是否正常：

1. 打开命令行（Windows 用 CMD/PowerShell，macOS/Linux 用终端）；
2. 输入以下 2 条命令，若显示版本号则成功：
   💻 rustc --version # 示例输出：rustc 1.78.0 (9b00956e5 2024-04-29)
   💻 cargo --version # 示例输出：cargo 1.78.0 (54d8815d0 2024-03-26)

❌ 常见验证失败原因

• Windows：未重启命令行 / 未用管理员权限；
• macOS/Linux：未执行 source $HOME/.cargo/env。

六、💡 Rust 基础使用技巧

1. 更新 Rust 版本

💻 rustup update # 升级到最新稳定版

2. 卸载 Rust 环境

💻 rustup self uninstall # 输入 y 确认卸载

3. 创建第一个 Rust 项目（新手必试）

1. 创建项目：💻 cargo new hello_world（自动生成标准项目结构）；
2. 进入项目目录：💻 cd hello_world；
3. 编译并运行：💻 cargo run；
4. 成功输出：Hello, world!（代码在 src/main.rs 中，可编辑）。

七、🚀 国内用户加速建议

国内访问 Rust 官方服务器速度慢，配置 中国科学技术大学（USTC）镜像 加速：

1. 临时生效（仅当前命令行）

2. 永久生效（所有命令行）

• Windows：

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」；
  2. 点击「系统变量」→「新建」，分别添加：
     • 变量名：RUSTUP_DIST_SERVER，值：https://mirrors.ustc.edu.cn/rust-static
     • 变量名：RUSTUP_UPDATE_ROOT，值：https://mirrors.ustc.edu.cn/rust-static/rustup

• macOS/Linux：

  1. 终端输入：💻 nano ~/.bashrc（若用 zsh 则输入 nano ~/.zshrc）；
  2. 按 Ctrl+V 到文件末尾，粘贴临时生效的 2 条 export 命令；
  3. 按 Ctrl+O 保存，Ctrl+X 退出；
  4. 生效：💻 source ~/.bashrc（或重启终端）。

八、❓ 常见问题与解决方法

九、💾 本地 Word 排版与保存步骤

1. 排版设置（让文档更美观）

2. 保存步骤

1. 打开「Microsoft Word」或「WPS 文字」；
2. 将本教程内容复制粘贴到文档中，按上述建议调整格式；
3. 点击「文件」→「保存」，选择保存路径；
4. 「保存类型」选择「Word 文档（.docx）」，点击「保存」即可。

✅ 完成以上步骤后，即可获得一份排版清晰、带图标的本地 Rust 安装教程，方便后续查阅和分享！

分享到：

赞 (0) 打赏