Linux如何安装Rust编程环境

使用 rustup 安装 Rust 是推荐的做法。如果选择 apt install rustc 或手动编译，容易遇到 cargo 找不到或 linker 报错的问题。绝大多数安装失败都源于这一步选择错误。

当安装遇到问题时，可以按照以下步骤排查常见故障。

为什么 cargo 命令不存在？

原因通常是路径未加入系统搜索目录。rustup 将二进制文件存放在 $HOME/.cargo/bin，但系统默认不识别该路径。路径未配置，相当于程序无法被直接调用。

• 临时生效：执行 source "$HOME/.cargo/env"。注意引号不可省略，防止用户名含空格导致解析错误。
• 永久生效：将上述命令添加到 ~/.bashrc 或 ~/.zshrc 末尾，然后执行 source ~/.bashrc。
• 验证：执行 which cargo，应返回类似 /home/xxx/.cargo/bin/cargo 的路径。若报错或返回 /usr/bin/cargo，说明路径尚未生效。

cargo build 报 linker `cc` not found，怎么办？

此问题与 Rust 本身无关，而是系统缺少 C 工具链。Rust 编译器不内置链接器，默认调用系统的 cc（通常为 gcc）。最小化 Linux 系统（如 Ubuntu Server、Docker 镜像、WSL2）未预装该工具。

• Ubuntu/Debian：sudo apt install build-essential。仅安装 gcc 不够，build-essential 包含 make、libc6-dev 等完整依赖。
• CentOS/RHEL/Fedora：sudo dnf groupinstall "Development Tools"。旧版本使用 yum。
• WSL2 用户：建议额外执行 sudo apt install libssl-dev，否则 reqwest 等 crate 会编译失败。
• 验证：执行 cc --version 输出版本号，且 cargo build 不再报错，即表示问题已解决。

国内安装卡在 downloading component 'rustc'？

这不是网络断开，而是 static.rust-lang.org 在国内访问受限或 DNS 被污染。中断后残留缓存未清除，即使设置镜像源也无效。

• 第一步，清理缓存：rm -rf $HOME/.rustup $HOME/.cargo。
• 第二步，设置镜像源（仅当前 shell 生效）：export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup。
• 第三步，执行安装命令：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh。注意参数 --proto '=https' 和 --tlsv1.2 不可省略，否则在 CentOS 7 或老旧 OpenSSL 环境下会报 TLS 握手失败。

易被忽略的三个要点：环境变量未 source、C 工具链未安装、镜像源未在安装前设置。任意一项遗漏都可能导致安装停滞在看似异常的位置。