Rust在Ubuntu上怎么搭建环境

在 Ubuntu 上搭建 Rust 开发环境，其实没那么玄乎。

整个流程走下来，无非就是装工具链、配置镜像、然后上手建个项目跑一跑。下面把这些步骤拆开说清楚，顺便把踩坑的地方也点出来。

一、安装步骤

搭建 Rust 开发环境，通常有两种方式：一是用系统包管理器直接装，二是用 rustup 安装官方推荐的工具链。这里重点说 rustup 的方式，因为它能让你轻松切换版本、更新工具链。

第一步，先更新系统并装上基础编译工具。这一步很关键，因为后面需要用到 gcc 和 make 来链接生成可执行文件：

sudo apt update && sudo apt install -y curl build-essential gcc make

然后，使用 rustup 安装最新稳定版工具链。这个命令会把 rustc（编译器）和 Cargo（包管理器和构建工具）一起装上：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装过程中选择默认项就行（安装稳定版 + Cargo）。

装完之后，需要激活环境变量，让系统能找到新装好的工具链。运行下面这个命令，或者直接关掉终端重新打开：

source $HOME/.cargo/env

最后验证一下安装是否成功：

rustc --version 和 cargo --version，如果能看到版本号，就算搞定。

二、国内镜像加速（可选）

在国内环境下，下载速度和稳定性是个现实问题。好在可以通过配置镜像来加速，分两种情况。

方式一：安装前设置环境变量

如果你希望在下载 Rust 工具链时就快一些，可以在执行 rustup 安装命令之前，先设置这两个环境变量：

export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static

export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup

然后再执行 rustup 安装命令。

方式二：安装后配置 Cargo 镜像

如果工具链已经装好了，但下载依赖包时太慢，可以配置 Cargo 的镜像源。编辑 ~/.cargo/config.toml 文件，加入以下内容：

使用清华源：

[registries.crates-io]
index = "https://mirrors.tuna.tsinghua.edu.cn/crates.io-index"

或者使用中科大源：

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

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

需要注意的是，如果镜像不可用，先检查一下拼写和协议（git 还是 https），或者暂时移除镜像配置恢复默认。

三、创建项目与常用命令

Cargo 是 Rust 的标配，用它创建和管理项目非常方便。

创建一个新项目并进入目录：

cargo new hello_world && cd hello_world

直接运行项目：

cargo run

这条命令等价于先 cargo build 再执行生成的可执行文件。

如果只想构建，不运行：

cargo build（调试版），cargo build --release（发布版，优化更充分）

如果只想快速检查代码能不能通过编译，用 cargo check，速度比完整构建快不少。

当然，如果你只是写个单文件，直接用 rustc 编译也行：

rustc main.rs && ./main

日常维护方面，更新工具链用 rustup update，卸载用 rustup self uninstall。

项目目录下有两个关键文件：Cargo.toml 是项目的清单和依赖配置文件，Cargo.lock 则锁定依赖的精确版本，确保不同环境下构建一致。

四、常见问题与进阶

编译报错 “linker 'cc' not found”

这通常是因为系统里缺少 GNU 链接器或编译器工具链。解决办法很简单，装上 build-essential 就行：

sudo apt install -y build-essential

确保 gcc 或 cc 命令可用。

版本过旧或系统级安装需求

如果你用系统包管理器安装：sudo apt install -y rustc cargo，确实比较方便，但系统仓库里的版本通常比较旧。适合需要统一系统管理、不追求最新特性的场景。想尝鲜的同学还是建议优先用 rustup。

交叉编译示例

以编译到 ARMv7 架构为例，步骤也不复杂。

首先安装交叉编译工具链：

sudo apt-get install -y gcc-arm-linux-gnueabihf

然后通过 rustup 添加目标架构：

rustup target add armv7-unknown-linux-gnueabihf

接着配置链接器。新建或编辑 ~/.cargo/config.toml：

[target.armv7-unknown-linux-gnueabihf]
linker = "arm-linux-gnueabihf-gcc"

最后构建：

cargo build --release --target=armv7-unknown-linux-gnueabihf

说实话，交叉编译这块坑不少，但按这个流程走，基本能一次搞定。

先说这些。搭建环境只是第一步，真正有意思的还在后面。