如何在Linux上配置Rust环境

在Linux上配置Rust开发环境，其实比想象中要简单——只要按下面几步走，基本不会遇到什么大坑。当然，前提是你选对了工具链管理方式。来看看具体怎么做。

1. 安装Rust工具链（推荐使用rustup）

rustup是Rust官方推出的工具链管理工具，支持多版本切换、跨平台安装，还能自动更新——在Linux下配置Rust环境，它算是首选了。打开终端，执行下面这条命令就能下载并运行安装脚本：

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

脚本会引导你一步步走完安装流程：接受许可协议、选择默认工具链，这些都不复杂。装完之后，千万别忘了激活环境变量，否则Rust命令可没法全局生效：

source $HOME/.cargo/env

如果你用的是Zsh，也可以用下面这条：

source ~/.zshrc

验证安装是否成功？运行以下命令，应该能看到rustc和cargo的版本信息：

rustc --version && cargo --version

当然，如果你偏好系统包管理器，比如Ubuntu/Debian上直接：

sudo apt update && sudo apt install rustc cargo

但必须提醒一句：系统包管理器的版本往往滞后，官方还是更推荐rustup——毕竟能第一时间拿到最新稳定版Rust。

2. 配置环境变量

如果安装时没有自动配置环境变量，那就需要手动把Rust工具链路径（~/.cargo/bin）加到Shell配置文件中。以~/.bashrc或~/.zshrc为例：

echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc  # Debian/Ubuntu
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc   # Zsh

保存后，运行下面的命令让配置立即生效：

source ~/.bashrc  # 或 source ~/.zshrc

环境变量有没有配置对？试试这个：

echo $PATH | grep ".cargo/bin"

如果输出包含.cargo/bin，那就没问题了。

3. 安装必要依赖（编译Rust项目所需）

如果Rust项目涉及到C/C++代码——比如通过cc crate调用原生库——那还得装一套构建工具链。不同发行版的安装命令略有差异，这里列一下常用的：

• Debian/Ubuntu：

  sudo apt update && sudo apt install build-essential

• Fedora：

  sudo dnf groupinstall "Development Tools" && sudo dnf install gcc

• Arch Linux：

  sudo pacman -S base-devel

这些工具主要用来编译项目中原生的扩展模块，装上之后基本就万事俱备了。

4. 配置代码编辑器（提升开发效率）

说到编辑器，**Visual Studio Code（VS Code）**再配上rust-analyzer扩展，算是当前比较主流的组合。代码补全、语法高亮、错误检查，这些功能全都有，开发效率能提升不少。

• 安装VS Code：

  sudo snap install --classic code  # Ubuntu/Debian（Snap方式）

• 安装rust-analyzer：打开VS Code后，按下Ctrl+Shift+X打开扩展面板，搜索“rust-analyzer”，点击“安装”就行。

5. 创建并运行第一个Rust项目

万事俱备，接下来就可以用cargo创建项目了。这个命令会同时完成包管理和构建工作：

cargo new hello_rust
cd hello_rust

项目目录结构长这样：

hello_rust/
├── Cargo.toml   # 项目配置文件（依赖管理）
└── src/
    └── main.rs  # 主程序入口（默认包含"Hello, world!"示例）

怎么运行？一句话搞定：

cargo run

编译并执行，终端上就会输出"Hello, world!"。如果只想编译不运行，可以这样：

cargo build

编译出来的可执行文件放在target/debug/目录下，直接执行也行。

6. 可选优化：配置国内镜像（加速依赖下载）

国内网络环境下，依赖下载速度可能让人着急。这时候配置国内镜像源就能派上用场了——清华大学镜像就是个不错的选择。编辑~/.cargo/config文件（不存在就新建），加入以下内容：

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

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

保存之后，cargo就会优先从国内镜像下载依赖，速度提升立竿见影。属于可配可不配，但配了绝对省心。