Rust项目在Ubuntu上的配置指南 - 问答

1. 更新系统包列表
在安装任何工具前，建议先更新Ubuntu的系统包列表，确保获取最新的软件版本：

sudo apt update

2. 安装Rust工具链（推荐使用rustup）
Rust官方推荐通过rustup工具管理Rust版本（支持多版本切换、自动更新）。打开终端，运行以下命令：

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

按照终端提示选择默认选项（安装稳定版Rust+Cargo包管理器）。安装完成后，需要激活环境变量：

source $HOME/.cargo/env

或重启终端使环境变量生效。

3. 验证Rust安装
通过以下命令检查Rust编译器（rustc）和包管理器（cargo）是否安装成功：

rustc --version  # 显示Rust编译器版本（如rustc 1.72.1）
cargo --version  # 显示Cargo包管理器版本（如cargo 1.72.0）

若输出版本号，则说明安装成功。

4. 配置国内镜像加速（可选，提升下载速度）
若下载Rust工具链或依赖时速度较慢，可设置国内镜像源（如中科大、清华）：

临时镜像（单次安装有效）：

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

永久镜像（写入环境变量）：
将上述命令添加到~/.bashrc或~/.zshrc文件末尾，然后运行source ~/.bashrc生效。
Cargo依赖镜像：
编辑~/.cargo/config文件，添加以下内容（以清华镜像为例）：
```
[source.crates-io]
replace-with = 'tuna'

[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index"
```
这样Cargo会优先从国内镜像下载依赖。

5. 安装系统依赖（避免编译错误）
Rust项目编译时可能需要C/C++编译工具链（如gcc、make）及系统库（如openssl）。通过以下命令安装：

sudo apt install -y build-essential pkg-config libssl-dev

其中，build-essential包含gcc、make等基础编译工具；libssl-dev用于支持SSL/TLS加密功能（部分项目依赖）。

6. 创建并运行第一个Rust项目
使用Cargo快速创建新项目：

cargo new hello_rust  # 创建名为hello_rust的项目（自动生成src/main.rs）
cd hello_rust         # 进入项目目录

运行项目：

cargo run  # 编译并运行项目（输出Hello, world!)

Cargo会自动处理依赖下载、编译和链接，简化项目流程。

7. 管理Rust项目依赖
Rust项目的依赖通过Cargo.toml文件定义（位于项目根目录）。例如，添加serde（JSON序列化库）和rand（随机数生成库）：

[dependencies]
serde = { version = "1.0", features = ["derive"] }  # 支持结构体派生
rand = "0.8"                                      # 随机数功能

添加依赖后，运行以下命令下载并编译依赖：

cargo build

更新所有依赖到最新版本：

cargo update

查看依赖树（了解依赖关系）：

cargo tree

Cargo会自动生成Cargo.lock文件，锁定依赖版本，确保不同环境构建一致性（需提交到版本控制系统）。

8. 可选：安装常用Rust工具

代码检查（Clippy）：检测代码中的潜在错误和不规范写法：
```
rustup component add clippy
cargo clippy  # 运行检查
```

代码格式化（Rustfmt）：统一代码风格：

rustup component add rustfmt
cargo fmt  # 格式化代码

文档生成（Ripgrep）：快速搜索代码：

cargo install ripgrep
rg "keyword"  # 搜索关键词

这些工具能显著提升开发效率和代码质量。

0 赞

0 踩