Linux怎么安装Rust编程环境

说实话，用 rustup 装 Rust 才是正解。你不动脑子走捷径，踩 apt install rustc 或者手动编译那条路，十有八九会卡在 cargo 找不到，或者 linker 报错上。别问为什么是“十有八九”，因为 99% 的安装失败，都是这一步选错了。

怎么？又卡住了？别急，咱们先把最常见的坑填平。

为什么 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，怎么办？

这就更冤了——其实是系统根本没有 C 工具链，跟 Rust 本身没半毛钱关系。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 工具链没装、镜像源没在安装前设置。这三个点任意一个漏掉，都会让安装停在看似“莫名其妙”的地方。