必须用rustup安装,且需依次解决环境变量未加载(执行source "$home/.cargo/env")、缺失c工具链(如ubuntu需sudo apt install build-essential)、未配置清华镜像源(提前export rustup_dist_server=https://mirrors.tuna.tsinghua.edu.cn/rustup)三大硬性依赖。

cargo 命令不存在?error: linker `cc` not found?下载卡在 downloading component 'rustc'?别折腾系统包管理器或手动编译——用 rustup 装,但必须按顺序解决三个硬性依赖。
为什么 cargo 命令根本找不到
安装脚本确实把 cargo 放进了 $HOME/.cargo/bin,但这个路径默认不在 $PATH 里。source "$HOME/.cargo/env" 不是提示,是强制步骤。
- 立即生效:运行
source "$HOME/.cargo/env"(注意引号,防路径含空格) - 永久生效:把这行加到
~/.bashrc或~/.zshrc末尾,再执行source ~/.bashrc - 验证是否成功:
which cargo应输出类似/home/xxx/.cargo/bin/cargo,而不是报错或返回/usr/bin/cargo
error: linker `cc` not found 的真实原因
Rust 编译器本身不带链接器,cargo build 默认调用系统 cc(通常是 gcc)。最小化 Linux 发行版(Ubuntu Server、WSL2、Docker 镜像)压根没装 C 构建工具,和 Rust 是否装上完全无关。
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI,零 GUI 开销。
- Ubuntu/Debian:运行
sudo apt install build-essential(只装gcc不够,它缺make和头文件) - CentOS/RHEL/Fedora:
sudo dnf groupinstall "Development Tools" - WSL2 用户额外建议:
sudo apt install libssl-dev,否则reqwest等 crate 会编译失败 - 验证:
cc --version能输出版本号,且cargo build不再报该错误
国内网络卡在 downloading component 'rustc' 怎么办
这不是断网,是 static.rust-lang.org 在国内被限速或 DNS 污染。中断后残留未清,换源也无效。
- 必须在运行安装脚本前设置镜像源:
export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup - 确认生效:
echo $RUSTUP_DIST_SERVER应输出完整 URL - 再执行安装:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh - 如果已失败退出,先清理残留:
rm -rf $HOME/.rustup $HOME/.cargo,再重试
为什么千万别用 apt install rustc
Ubuntu/Debian 仓库里的 rustc 包通常滞后 1–2 个大版本(比如系统提供 1.78,而 stable 已是 1.86),且不带 cargo、rust-docs、rustfmt 等关键组件。
- 执行
cargo build会直接报command not found: cargo,不是你漏敲命令,是根本没装上 - 如果之后再装
rustup,两个 Rust 会共存:rustc --version可能显示旧版,cargo又只认新版路径,构建失败时极难排查 - 即使新版发行版(如 Ubuntu 24.04+)的
sudo apt install rust会带cargo,也无法用rustup default切换nightly/stable,也不支持rustup component add rust-src










