macOS Rust 安装教程：自定义 CARGO_HOME 和 RUSTUP_HOME

macOS 将 Rust 安装到自定义目录 `$HOME/devops/rust`

适用环境

复制代码

系统：macOS
Shell：zsh
架构：Apple Silicon / aarch64-apple-darwin

为什么这样安装

bash 复制代码

默认 Rust 会安装到用户目录下的 .cargo 和 .rustup。

这里统一安装到：

$HOME/devops/rust

方便集中管理本机开发语言和工具，例如：

$HOME/devops/go
$HOME/devops/rust
$HOME/devops/python

1. 创建 `devops` 目录

命令：

bash 复制代码

mkdir -p "$HOME/devops"

实际效果：

bash 复制代码

创建统一开发环境目录：

$HOME/devops

说明：

复制代码

devops 用于统一管理本机开发语言和工具。

2. 创建 Rust 安装目录

命令：

bash 复制代码

mkdir -p "$HOME/devops/rust/cargo" "$HOME/devops/rust/rustup"

实际效果：

bash 复制代码

创建 Rust 相关目录：

$HOME/devops/rust/cargo
$HOME/devops/rust/rustup

3. 设置 Rust 安装环境变量

命令：

bash 复制代码

export CARGO_HOME="$HOME/devops/rust/cargo"
export RUSTUP_HOME="$HOME/devops/rust/rustup"

实际效果：

bash 复制代码

Cargo 安装到：

$HOME/devops/rust/cargo

Rustup 安装到：

$HOME/devops/rust/rustup

4. 执行 Rust 官方安装脚本

命令：

arduino 复制代码

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

实际效果：

javascript 复制代码

Rustup 检测到安装目录：

Rustup home directory:
  /Users/kryon/devops/rust/rustup

Cargo home directory:
  /Users/kryon/devops/rust/cargo

Cargo bin directory:
  /Users/kryon/devops/rust/cargo/bin

5. 选择标准安装

安装器提示：

arduino 复制代码

1) Proceed with standard installation (default - just press enter)
2) Customize installation
3) Cancel installation
>

输入：

复制代码

实际效果：

yaml 复制代码

开始安装 stable 工具链：

default host triple: aarch64-apple-darwin
default toolchain: stable
profile: default
modify PATH variable: yes

6. 安装完成

实际效果：

csharp 复制代码

stable-aarch64-apple-darwin installed - rustc 1.96.0 (ac68faa20 2026-05-25)

Rust is installed now. Great!

已安装组件：

c 复制代码

cargo
clippy
rust-docs
rust-std
rustc
rustfmt

7. 加载当前终端环境

命令：

bash 复制代码

. "$HOME/devops/rust/cargo/env"

实际效果：

复制代码

当前终端可以直接使用 rustc、cargo、rustup。

8. 持久化环境变量

命令：

bash 复制代码

cat >> ~/.zshrc <<'EOF'

export CARGO_HOME="$HOME/devops/rust/cargo"
export RUSTUP_HOME="$HOME/devops/rust/rustup"
export PATH="$CARGO_HOME/bin:$PATH"
EOF

实际效果：

bash 复制代码

将 Rust 环境变量写入 ~/.zshrc。

之后新打开的终端会自动加载 Rust 环境。

9. 重新加载 zsh 配置

命令：

bash 复制代码

source ~/.zshrc

实际效果：

bash 复制代码

当前终端立即加载 ~/.zshrc 中的 Rust 环境变量。

10. 验证 `rustc`

命令：

css 复制代码

rustc --version

实际效果：

scss 复制代码

rustc 1.96.0 (ac68faa20 2026-05-25)

说明：

复制代码

验证 Rust 编译器 rustc 是否安装成功。

11. 验证 `cargo`

命令：

css 复制代码

cargo --version

实际效果：

scss 复制代码

cargo 1.96.0 (30a34c682 2026-05-25)

说明：

复制代码

验证 Rust 包管理器和构建工具 cargo 是否安装成功。

12. 验证 `rustup`

命令：

css 复制代码

rustup --version

实际效果：

vbnet 复制代码

rustup 1.29.0 (28d1352db 2026-03-05)
info: This is the version for the rustup toolchain manager, not the rustc compiler.
info: the currently active `rustc` version is `rustc 1.96.0 (ac68faa20 2026-05-25)`

说明：

复制代码

验证 Rust 工具链管理器 rustup 是否安装成功。

13. 验证安装路径

命令：

bash 复制代码

which rustc
which cargo
which rustup

预期效果：

bash 复制代码

$HOME/devops/rust/cargo/bin/rustc
$HOME/devops/rust/cargo/bin/cargo
$HOME/devops/rust/cargo/bin/rustup

说明：

复制代码

确认当前使用的是自定义目录下的 Rust。

14. 卸载 Rust

命令：

lua 复制代码

rustup self uninstall

说明：

复制代码

卸载通过 rustup 安装的 Rust 工具链。

最终结果

bash 复制代码

Rust 安装成功。

统一开发环境目录：

$HOME/devops

Rust 安装目录：

$HOME/devops/rust/rustup
$HOME/devops/rust/cargo

当前版本：

rustc 1.96.0
cargo 1.96.0
rustup 1.29.0

macOS Rust 安装教程：自定义 CARGO_HOME 和 RUSTUP_HOME

macOS 将 Rust 安装到自定义目录 $HOME/devops/rust

适用环境

为什么这样安装

1. 创建 devops 目录

2. 创建 Rust 安装目录

3. 设置 Rust 安装环境变量

4. 执行 Rust 官方安装脚本

5. 选择标准安装

6. 安装完成

7. 加载当前终端环境

8. 持久化环境变量

9. 重新加载 zsh 配置

10. 验证 rustc

11. 验证 cargo

12. 验证 rustup

13. 验证安装路径

14. 卸载 Rust

最终结果

macOS 将 Rust 安装到自定义目录 `$HOME/devops/rust`

1. 创建 `devops` 目录

10. 验证 `rustc`

11. 验证 `cargo`

12. 验证 `rustup`