Linux下Rust环境搭建教程：cargo安装与换源方法

本文详细讲解了在Linux系统中高效搭建Rust开发环境的完整流程，重点解决国内用户安装rustup和cargo时普遍遭遇的网络卡顿、超时及链接器缺失等痛点问题：不仅强调通过rustup一键安装即可自动集成cargo，更明确指出换源必须同步配置两处——工具链下载（via RUSTUP_DIST_SERVER或rustup set dist-server）与crate依赖下载（via ~/.cargo/config.toml），缺一不可；同时深入剖析安装失败主因（static.rust-lang.org限速/DNS污染）、链接器报错根源（缺少build-essential等C编译工具链），并提供各发行版适配命令、环境变量持久化方案及企业网络下的应对策略，让读者避开常见坑，快速获得开箱即用的稳定Rust开发环境。

直接装 rustup 就行，cargo 会自动带上；换源分两层——rustup 工具链下载用 RUSTUP_DIST_SERVER，crate 依赖下载用 ~/.cargo/config.toml，漏掉任何一层都会卡住或超时。

rustup 安装失败常见原因和绕过方法

执行 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 卡在 downloading component 'rustc'，不是网络断了，是官方 CDN（static.rust-lang.org）在国内被限速或 DNS 污染。

• 别等，先 Ctrl+C 中断，再删残留：rm -rf $HOME/.rustup $HOME/.cargo
• 设镜像变量（只对当前 shell 有效）：export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
• 再跑安装命令，不要跳过 source "$HOME/.cargo/env" ——否则 cargo 命令根本不存在
• 验证：cargo --version 和 rustc --version 都能输出才算真正就位

为什么装完 cargo build 还报 error: linker `cc` not found

Rust 编译器不自带链接器，cargo build 默认调用系统 cc（通常是 gcc），但最小化安装的 Linux（比如云服务器、WSL2）压根没装 C 工具链。

• Ubuntu/Debian：sudo apt install build-essential（仅装 gcc 不够，build-essential 还含 make、libc6-dev 等）
• CentOS/RHEL/Fedora：sudo dnf groupinstall "Development Tools"
• Arch Linux：sudo pacman -S base-devel
• WSL2 用户建议额外加装：sudo apt install libssl-dev，否则像 reqwest 这类 crate 会编译失败
• 验证是否生效：cc --version 能输出版本号，且 cargo build 不再报 linker 错误

换源必须配两处，只改 cargo config 不解决工具链下载慢

cargo 下载依赖走 crates.io，而 rustup 下载 rustc、cargo 自身二进制包走的是另一个地址（static.rust-lang.org），两者镜像源不同，不能混用。

• 工具链下载换源（影响 rustup install / rustup update）：
  rustup set dist-server https://mirrors.tuna.tsinghua.edu.cn/rust-static
• crate 依赖换源（影响 cargo build / cargo add）：
  编辑 ~/.cargo/config.toml，写入：

[source.crates-io]
replace-with = "ustc"

[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index"

• 改完不用重启，直接 cargo search rand 测试是否走镜像 —— 如果返回结果快且无超时，说明生效
• 别碰 RUSTUP_UPDATE_ROOT，它只管 rustup 自身更新，跟工具链下载无关

容易被忽略的细节：环境变量加载时机和权限问题

source "$HOME/.cargo/env" 只对当前终端生效；新开终端或 VS Code 内置终端默认不加载，就会提示 command not found: cargo。

• 永久生效：把这行加到 ~/.bashrc 或 ~/.zshrc 末尾，然后 source ~/.bashrc
• 如果用 sudo 启动 IDE（比如 sudo code），IDE 会继承 root 的环境，但 $HOME/.cargo/env 是用户级路径，root 找不到 —— 改用普通用户启动 IDE
• 某些企业网络会拦截 HTTPS 的 SNI 域名（比如访问 static.rust-lang.org 时），表现为连接超时但无明确错误，此时只能换网络或配代理，镜像也救不了

到这里，我们也就讲完了《Linux下Rust环境搭建教程：cargo安装与换源方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！