Linux系统中Rust包管理工具使用教程

Linux系统中Rust包管理工具使用教程

一 安装与准备

• 使用官方工具链管理器 rustup 安装（推荐）：
  • 安装命令：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • 配置环境：source $HOME/.cargo/env（或将 export PATH=$HOME/.cargo/bin:$PATH 加入 shell 配置）
  • 验证：rustc --version、cargo --version
• 发行版仓库安装（可选）：如 Ubuntu/Debian 可执行 sudo apt install rust cargo
• 国内镜像加速（可选，提升下载速度）：
  • rustup 镜像：
    • export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
    • export RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup
  • crates.io 索引镜像：在 ~/.cargo/config.toml 添加
    • [source.crates-io] replace-with = 'mirror'
    • [source.mirror] registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"
    • [registries.mirror] index = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

二 快速上手 创建与运行项目

• 创建项目：
  • 二进制可执行：cargo new my_app（生成 src/main.rs）
  • 库项目：cargo new my_lib --lib（生成 src/lib.rs）
• 构建与运行：
  • 构建：cargo build（开发构建，输出到 target/debug）
  • 运行：cargo run（编译并运行）
  • 发布构建：cargo build --release（优化构建，输出到 target/release）
• 常用检查与清理：
  • 快速检查可编译：cargo check（比 build 更快）
  • 运行测试：cargo test
  • 生成文档：cargo doc
  • 清理产物：cargo clean

三 依赖管理 Cargo.toml 与版本控制

• 添加依赖：编辑项目根目录的 Cargo.toml，在 [dependencies] 下写入包名与版本
  • 示例：
    • serde = { version = "1.0", features = ["derive"] }
    • rand = "0.8"
• 版本号语义与范围：
  • 精确版本：=1.2.3
  • 兼容版本：^1.2.3（保持主版本不变，允许次版本与补丁更新）
  • 范围：>=1.2.0, <2.0.0
• 更新与锁定：
  • 更新依赖到兼容范围的最新版本：cargo update（更新 Cargo.lock 中记录的精确版本）
  • 锁定文件：Cargo.lock 记录每个依赖的确切版本，用于保证可复现构建；团队协作与发布时通常应提交此文件
• 依赖可视化：
  • 查看依赖树：cargo tree

四 常用命令速查表

五 进阶与常见问题

• 交叉编译简述：
  • 默认构建为本机目标；跨平台需在 Cargo.toml 配置目标工具链（如 x86_64-unknown-linux-gnu、aarch64-linux-android 等），并准备相应 target 与链接器；可使用 cargo build --target <triple> 指定目标三元组
• 工具链管理（rustup）：
  • 安装工具链：rustup install stable|beta|nightly
  • 切换默认：rustup default stable
  • 更新工具链：rustup update
  • 卸载：rustup self uninstall
• 全局工具安装位置与卸载：
  • 全局包默认安装到 $HOME/.cargo/bin，请确保该目录在 PATH
  • 卸载：cargo uninstall <crate>
• 常见问题排查：
  • 命令未找到：确认 source $HOME/.cargo/env 已执行或 ~/.cargo/bin 已加入 PATH
  • 下载慢：配置 rustup 与 crates.io 镜像源
  • 版本冲突或不一致：优先使用 cargo update 与锁文件 Cargo.lock 保证复现构建；必要时回退版本或调整版本范围