Debian上如何管理Rust项目

假设你已经在用 Debian，想好好折腾 Rust 项目——别急，先把“家伙”备齐。Rust 的编译器（rustc）和包管理器（Cargo），都建议通过 rustup 来安装，这是官方推荐的工具链管理方式，胜在版本更新灵活，想用什么版本随你切换。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
# 将Rust添加到PATH环境变量
rustup update
# 更新至最新稳定版

当然，也可以从 Debian 官方仓库直接装——不过说实话，这种方式灵活性差，真不推荐。除非你明确知道自己为什么需要这样做。

sudo apt update && sudo apt install rustc cargo

装好之后，记得用 rustc --version 和 cargo --version 看一眼，验证一下环境是不是通的。

创建项目：Cargo 帮你省掉手搓的麻烦

一切就绪，来创建第一个 Rust 项目。Cargo 提供了项目模板，一键生成，省得自己手动搭目录结构。

cargo new my_rust_project
# 创建名为my_rust_project的项目（默认生成lib.rs）
cd my_rust_project
# 进入项目目录

如果你需要的是可直接运行的程序，加个 --bin 参数就行：

cargo new my_cli_tool --bin

项目结构长这样：

my_rust_project/
├── Cargo.toml
# 项目配置文件（依赖、元数据）
└── src/
    └── main.rs
# 主程序入口

依赖管理：Cargo 的看家本事

说到依赖，这才是 Cargo 的核心能力。所有依赖都在 Cargo.toml 里声明，清晰又直接：

• 添加依赖：直接编辑 Cargo.toml，写上依赖名和版本号。比如要处理序列化，可以加 serde：

[dependencies]
serde = "1.0"
# 精确版本
rand = { version = "0.8", features = ["derive"] }
# 带特性（如派生宏）

保存后运行 cargo build，Cargo 会自动下载依赖并开始编译。整个过程几乎不需要你操心。

• 更新依赖：用 cargo update 更新 Cargo.lock 文件——这个文件锁定了依赖的精确版本，用来确保可重复构建。如果想只更新某个依赖，比如 serde，可以这样：

cargo update -p serde

• 查看依赖树：依赖多了容易搞不清谁依赖谁。用 cargo tree 可以清晰看到直接与间接依赖的关系，前提是得先装上 cargo-tree 插件：

cargo install cargo-tree
cargo tree

构建与运行：从代码到可执行文件

依赖管理好了，就该让项目跑起来了。整个过程分为几步，但都很直观：

• 构建项目：直接用 cargo build，生成的可执行文件放在 target/debug/ 目录下，调试模式，包含调试信息。如果你在追求性能，就上 cargo build --release，产物在 target/release/，没有额外的调试数据，运行速度更快。
• 运行项目：cargo run 会自动检测文件改动并增量编译，然后直接运行。如果需要传参数，加 -- 就行：

cargo run -- arg1 arg2

• 执行测试：Rust 内置了测试框架。你可以在 tests/ 目录下写测试，也可以在函数前加 #[test] 注解。然后用 cargo test 一次跑完所有测试用例。

版本控制与协作：别把 target 传上去

项目做起来，版本控制肯定少不了。Git 是标配：

git init
# 初始化Git仓库
git add .
# 添加所有文件（包括Cargo.toml、src/）
git commit -m "Initial commit"
# 提交初始版本
git remote add origin https://github.com/username/my_rust_project.git
# 关联远程仓库
git push -u origin main
# 推送至远程分支

但这里有个坑：target/ 目录是编译产物，千万别放进去。建议在项目里加上 .gitignore，把 target/ 和 *.rs.bk（备份文件）都忽略掉。

持续集成：让 CI 替你盯着代码

项目上了规模之后，手动构建和测试就太慢了。持续集成（CI）可以帮你自动化整个流程。以 GitHub Actions 为例：

• 在项目根目录下创建 .github/workflows/ci.yml，写入以下内容：

name: CI
on: [push, pull_request]
# 触发条件：push或PR
jobs:
  build:
    runs-on: ubuntu-latest
    # 运行环境
    steps:
    - uses: actions/checkout@v2
    # 拉取代码
    - name: Set up Rust
      uses: actions-rs/setup-rust@v1
      with:
        rust-version: stable
    # 使用稳定版Rust
    - name: Build
      run: cargo build --verbose
    # 构建项目
    - name: Run tests
      run: cargo test --verbose
      # 运行测试

推送代码到 GitHub 后，CI 会自动触发，结果可以在仓库的 "Actions" 标签页里查看。省心得很。

打包与发布：把你的代码交付出去

项目做完了，怎么让别人用？

• 发布到 Crates.io：这是 Rust 官方的包注册表。先注册账号，然后：

cargo login
# 登录Crates.io（输入API token）
cargo publish
# 发布项目（需确保Cargo.toml中的version唯一）

• 创建 Debian 包：如果你想在 Debian/Ubuntu 上直接装包，可以用 cargo-deb 工具：

cargo install cargo-deb
# 安装cargo-deb
cargo deb
# 生成Debian包（位于target/debian/目录）
sudo dpkg -i target/debian/my_rust_project_*.deb
# 安装包

你还可以通过 package.metadata.deb 字段自定义包的名称、依赖等属性，具体参考 cargo-deb 的文档。

代码质量与维护：好项目是“养”出来的

代码写完了，不等于结束。维护阶段同样重要：

• 文档生成：用 cargo doc 基于代码中的 /// 注释生成文档，并支持在本地打开：

cargo doc --open
# 生成并打开文档（默认端口8000）

• 静态分析：cargo clippy 能帮你检查代码质量，发现潜在的问题。先装一下 clippy：

rustup component add clippy
cargo clippy
# 运行检查

• 格式化：团队协作时，统一的代码风格能省掉不少争吵。cargo fmt 帮你一键搞定：

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

这些小工具看似不起眼，但在长期维护中，它们带来的收益远超想象。从安装到发布，再到持续优化，这套流程一旦跑通，剩下的就是专注于写代码本身了。