国内mac更新rust工具链时,rustup update常因连接海外服务器而卡顿,需配置rsproxy.cn镜像源:临时执行export rustup_dist_server="https://rsproxy.cn" && export rustup_update_root="https://rsproxy.cn"后运行rustup update;或永久写入~/.zshrc并source生效,可将速度提升至3–8 mb/s,30秒内完成更新。

在国内Mac上更新Rust工具链时,直接运行 rustup update 往往卡在下载环节,因为默认连接的是海外服务器,国内网络环境下经常超时或限速到几十 KB/s,导致更新失败或耗时超过十分钟。
确认当前环境是否就绪
打开终端,先检查 rustup 是否已正确安装并识别:
rustup --version
如果提示 command not found: rustup,说明 Rust 工具链尚未安装或环境变量未生效,需先完成基础安装;若显示版本号(如 rustup 1.27.1),继续下一步。
再运行 rustup show,确认当前默认工具链(如 stable-aarch64-apple-darwin)和已安装组件。这一步能避免误更新不存在的通道。
执行更新操作
在终端中输入以下命令:
rustup update
该命令会同时更新所有已安装的工具链(stable/beta/nightly)及其组件(rustc、cargo、clippy 等)。它不改变当前默认工具链,只拉取最新补丁版本。
如果终端长时间停在 info: syncing channel updates for 'stable-aarch64-apple-darwin' 且无进度,说明正在从官方源下载——此时必须中断并切换镜像源。
使用国内镜像加速更新(关键步骤)
方法一:临时生效(仅本次更新)
在运行 rustup update 前,先执行以下三行命令:
export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn"
rustup update
方法二:永久生效(推荐)
将镜像配置写入 shell 配置文件,确保后续每次 rustup update 都自动走国内源:
echo 'export RUSTUP_DIST_SERVER="https://rsproxy.cn"' >> ~/.zshrc
echo 'export RUSTUP_UPDATE_ROOT="https://rsproxy.cn"' >> ~/.zshrc
source ~/.zshrc
【注意】必须执行 source ~/.zshrc 才能让新变量立即生效,否则 rustup 仍会尝试连接海外服务器。
完成配置后,再次运行 rustup update,速度通常可提升至 3–8 MB/s,整个更新过程一般在 30 秒内完成。
验证更新结果
更新完成后,运行:
rustc --version
cargo --version
对比更新前的版本号,确认已升级到最新 patch 版本(例如从 rustc 1.75.0 升至 rustc 1.75.1)。
再运行 rustup show,检查输出中 installed toolchains 下对应通道的日期是否为今日或最近两天,说明更新已成功写入本地。











