Linux系统安装Rust编程环境指南

坦率地说，使用 rustup 安装 Rust 是官方推荐的最佳方案。如果贪图省事选择 apt install rustc 或手动编译，十有八九会遇到 cargo 命令无法识别或 linker 报错的问题。之所以这么说，是因为超过 99% 的安装失败案例，根源都在于这一步选择错误。

安装过程中再次卡住？别着急，接下来我们将逐一解决最典型的 Rust 环境配置问题。

为什么 cargo 命令会提示未找到？

实际上并非没有安装成功，而是二进制文件所在的路径没有被加入系统的 PATH 搜索目录。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 或 clang）。许多最小化安装的 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 编译工具链、安装前未配置国内镜像源。只要其中一项缺失，就会导致安装过程在看似意想不到的位置卡住。