Rust 安装指南

本指南将帮助您在 macOS 系统上安装 Rust 编程语言及其相关工具链。

快速安装

使用 rustup（推荐方式）

运行以下命令来安装 Rust：

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

命令说明：

• 此命令会下载并运行 rustup 安装脚本
• rustup 是 Rust 的官方工具链管理器
• 安装过程中可能需要输入管理员密码
• 会自动安装最新的稳定版 Rust

安装成功后，您会看到以下提示信息：

Rust is installed now. Great!

安全提示： 如果您对安全性有顾虑，可以先下载脚本进行检查再运行。

配置环境变量

安装脚本会自动将 Rust 添加到系统 PATH 中，但需要重新启动终端才能生效。如果您想立即使用 Rust，请运行：

source $HOME/.cargo/env

永久配置（可选）：

根据您使用的 shell，在相应的配置文件中添加以下内容：

• Bash 用户：编辑 ~/.bash_profile
• Zsh 用户：编辑 ~/.zshrc

export PATH="$HOME/.cargo/bin:$PATH"

安装必要的系统依赖

Rust 需要链接器（linker）来编译程序。在 macOS 上，您需要安装 Xcode 命令行工具：

xcode-select --install

为什么需要这些工具：

• 链接器用于将编译后的代码组装成可执行文件
• 许多 Rust 包（crates）依赖 C/C++ 代码
• 一些系统级的开发工具也会用到

管理 Rust 安装

更新 Rust

使用 rustup 可以轻松更新到最新版本：

rustup update

您也可以查看可用的版本：

rustup show

管理工具链

安装特定版本的 Rust：

# 安装 beta 版本
rustup install beta

# 安装 nightly 版本
rustup install nightly

# 切换默认版本
rustup default stable

卸载 Rust

如需完全卸载 Rust 和 rustup：

rustup self uninstall

验证安装

检查 Rust 版本

运行以下命令验证 Rust 是否正确安装：

rustc --version

成功安装后，您应该看到类似以下的输出：

rustc 1.90.0 (1159e78c4 2025-09-14)

检查 Cargo 版本

Cargo 是 Rust 的包管理器和构建工具：

cargo --version

创建第一个项目

让我们创建一个简单的 “Hello, World!” 项目来测试安装：

# 创建新项目
cargo new hello_rust
cd hello_rust

# 运行项目
cargo run

如果看到 “Hello, world!” 输出，恭喜您！Rust 已经成功安装并可以正常使用了。

故障排除

常见问题

问题：命令未找到

• 确保已经重启终端或运行了 source $HOME/.cargo/env
• 检查 PATH 环境变量是否包含 $HOME/.cargo/bin

问题：编译错误

• 确保已安装 Xcode 命令行工具
• 运行 xcode-select --install 安装必要的开发工具

问题：权限错误

• 不要使用 sudo 运行 rustup 命令
• 确保对 $HOME/.cargo 目录有写入权限

获取帮助

如果遇到问题，可以通过以下渠道寻求帮助：

• Rust 官方论坛：users.rust-lang.org
• Discord 社群：Rust 官方 Discord 的 #beginners 频道
• Stack Overflow：使用 rust 标签提问
• GitHub：rust-lang/rust 项目页面

下一步

安装完成后，建议您：

1. 阅读 Rust 程序设计语言 官方教程
2. 探索 Rust by Example 实例教程
3. 查看 crates.io 了解可用的 Rust 包
4. 配置您喜欢的编辑器或 IDE 的 Rust 支持

---

快速参考：

• 安装：curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh
• 更新：rustup update
• 版本检查：rustc --version
• 创建项目：cargo new project_name
• 运行项目：cargo run