为什么ubuntu rust配置失败

ubuntu

小樊

2026-10-28 06:38:49

栏目: 编程语言

Ubuntu 上 Rust 配置失败的原因有很多，下面按最常见原因 → 解决思路给你梳理，方便对照排查。

一、网络问题（最常见）

现象

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 卡住或失败
报错：Failed to download, connection timeout

原因

国内访问 rustup.rs / crates.io 不稳定

解决

# 使用国内镜像
export RUSTUP_DIST_SERVER=https://rsproxy.cn
export RUSTUP_UPDATE_ROOT=https://rsproxy.cn/rustup

curl --proto '=https' --tlsv1.2 -sSf https://rsproxy.cn/rustup-init.sh | sh

Cargo 镜像（写入 ~/.cargo/config.toml）：

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

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

二、缺少依赖（Ubuntu 特有）

现象

安装成功，但 cargo build 报错
错误含：cc not found, linker error

解决

sudo apt update
sudo apt install -y build-essential curl gcc make pkg-config

如用到 SSL / 系统库：

sudo apt install -y libssl-dev

三、PATH 没配置

现象

rustc: command not found
刚装完就用不了

原因

没执行 source ~/.cargo/env

解决

source ~/.cargo/env

或写入 ~/.bashrc / ~/.zshrc：

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

四、权限问题

现象

Permission denied
用 sudo 装了 Rust

解决（不推荐 sudo 装）

rm -rf ~/.cargo ~/.rustup
# 重新用普通用户安装

五、架构 / 系统不兼容

常见情况

树莓派 / ARM
老版本 Ubuntu（< 18.04）

检查

uname -m
cat /etc/os-release

六、WSL 特殊情况

确保 WSL 网络正常
不要用 Windows 的 Rust，混用会乱

七、快速自检清单

rustc --version
cargo --version
echo $PATH | grep cargo

如果你能贴出具体报错信息（命令 + 完整错误），我可以直接帮你定位是哪一类问题。