在 Debian 上对 Rust 代码进行版本控制

一 环境与工具

工欲善其事，必先利其器。在 Debian 系统上开启 Rust 开发之旅，第一步自然是搭建一个得心应手的环境。

• 安装并初始化 Git：这是版本控制的基石。通过 sudo apt update && sudo apt install -y git 即可完成安装。紧接着，别忘了配置你的全局身份，使用 git config --global user.name “Your Name” 和 git config --global user.email “you@example.com” 来标记你的每一次提交。
• 安装 rustup：作为 Rust 官方的工具链管理器，rustup 是管理多个 Rust 版本的不二之选。一条命令 curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh 就能搞定。安装后，执行 source “$HOME/.cargo/env” 激活环境，之后便可以用 rustup show、rustup update、rustup default 等命令轻松管理工具链了。
• 安装质量工具：想让代码更专业？建议顺手装上 rustfmt 和 clippy。通过 rustup component add rustfmt clippy 安装后，cargo fmt 能自动格式化代码，而 cargo clippy 则像一位严格的代码审查员，帮你发现潜在的问题和改进点。

二 版本控制的核心做法

环境就绪后，接下来就是如何系统性地管理你的代码和依赖了。这里有几个核心实践，堪称 Rust 项目的“标配”。

• Git 分支策略：使用 Git 管理源码是基础。关键在于采用清晰的分支策略，比如按功能或修复创建独立分支（例如 main/develop/feature/x）。提交信息务必清晰规范，而利用 Pull Request 或 Merge Request 进行代码评审后再合并，则是保障代码质量的关键一环。
• 语义化版本（SemVer）：发布版本号可不是随便定的。在 Cargo.toml 的 [package] 部分维护 version = “X.Y.Z”，并遵循 MAJOR.MINOR.PATCH 的变更规则。简单来说，0.y.z 阶段意味着 API 尚不稳定，而一旦发布 1.0.0，就向用户承诺了 API 的稳定性。
• Git 标签标记发布点：每次正式发布，都应该用一个 Git 标签来定格。使用 git tag -a v0.1.0 -m “Release 0.1.0” 创建附注标签，再通过 git push origin v0.1.0（或 --tags 推送所有标签）将其同步到远程仓库，这样任何时候都能轻松回溯到特定的发布版本。
• 依赖版本控制：Rust 的依赖管理非常强大。常规依赖在 Cargo.toml 中指定版本范围（如 ^1.2）即可。但如果需要锁定到某个特定的提交或分支，可以使用 Git 依赖格式：{ git = “https://github.com/xxx/yyy”, rev = “” }。这为可重复构建和问题回溯提供了坚实保障。

三 推荐分支与发布流程

理论说完了，具体怎么操作呢？这里提供一个结合了主流实践、可直接套用的流程。

• 分支策略选择：GitHub Flow 或 Git Flow 都是成熟的选择。以简洁的 GitHub Flow 为例：从 main 分支创建特性分支 feature/x；开发完成后，在远端仓库发起 Pull Request；经过评审合并到 main 分支后，即可删除特性分支。需要发布时，直接在 main 分支上打上如 vX.Y.Z 的标签并推送即可。
• 发布流程要点：发布新版本前，按照以下步骤检查，能避免很多低级错误：
  1. 更新版本号：确保本地 main 分支上的 Cargo.toml 中的 version 字段已更新。
  2. 运行检查：依次执行 cargo test（运行测试）、cargo fmt --check（检查格式）、cargo clippy（静态分析），确保代码质量过关。
  3. 打标签并推送：使用 git tag -a v0.2.0 -m “Release 0.2.0” 创建标签，然后 git push origin v0.2.0 推送到远程。
  4. 发布到 crates.io：如果需要将库公开发布，执行 cargo publish 即可（前提是已登录并拥有权限）。

四 可选 使用 Jujutsu 提升体验

如果你觉得 Git 的某些操作略显繁琐，想尝试更现代的版本控制体验，那么 Jujutsu（简称 jj）值得一看。

• 什么是 Jujutsu？ 它是一个用 Rust 编写的现代化版本控制系统，最大的亮点是与现有 Git 仓库 100% 兼容。这意味着你可以在不迁移仓库的情况下，直接使用 jj 来操作 Git 仓库，享受其更直观的变更管理和撤销体验。
• 安装与使用：在 Debian 上，可以通过 Cargo 直接安装：cargo install --locked --bin jj jj-cli。其常用命令如 jj init / jj git clone、jj status、jj log、jj new、jj describe 等，设计上旨在减少暂存区（staging）、变基（rebase）和冲突处理带来的心智负担。对于希望提升团队协作流畅度的项目来说，这是一个不错的备选方案。

五 常用命令清单

最后，将上文提到的核心命令汇总如下，方便随时查阅。

• 环境与工具
  • 安装与配置：sudo apt install -y git；git config --global user.name/email；curl … | sh && source “$HOME/.cargo/env”；rustup show/update/default ；rustup component add rustfmt clippy。
• 代码与版本
  • 仓库与协作：git init；git clone ；git add/commit -m “msg”；git push -u origin main；git pull；git branch/checkout -b；git merge；git remote -v。
  • 标签与发布：git tag -a vX.Y.Z -m “msg”；git push origin vX.Y.Z（或 --tags）；同步更新 Cargo.toml 中的 version；cargo test/ fmt --check/ clippy；cargo publish（发布到 crates.io）。