Linux上Rust项目如何进行版本控制

Linux上Rust项目的版本控制实践

一 版本控制与语义化版本

• 使用 Git 进行源码版本管理，按功能或修复创建分支，通过 Pull Request 进行代码评审与合并，保持主分支稳定。
• 项目版本号写在 Cargo.toml 的 [package] version 字段，遵循 SemVer 2.0：格式为 MAJOR.MINOR.PATCH，先行版本如 1.0.0-alpha < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0；在 0.y.z 阶段，任何不兼容变更都应递增主版本。
• 用 Git 标签标记发布版本，建议与 Cargo 版本保持一致，例如：git tag -a v0.1.0 -m “Release 0.1.0”。

二 依赖版本与可复制构建

• 在 Cargo.toml 中声明依赖版本，必要时使用特性与版本约束；例如：serde = { version = “1.0”, features = [“derive”] }。
• Cargo.lock 的作用：二方应用/服务必须提交 Cargo.lock 以冻结依赖图，确保可复制构建；库（发布到 crates.io）不随包发布 Cargo.lock，但在仓库中仍应提交以保障 CI 可重复。
• 升级与精确锁定：cargo update 全局升级；cargo update -p 包名 局部升级；cargo update -p 包名 --precise 1.2.3 精确 pin 版本；用 cargo tree 查看依赖树与冲突。
• 使用 Git 依赖时尽量固定到 tag 或 rev，避免 master 漂移；需要临时替换上游依赖时，使用 [patch.crates-io] 而非已废弃的 [replace]。

三 发布流程与工具

• 遵循 SemVer 递增版本后，使用 cargo publish --dry-run 验证元数据与可发布性，再执行发布；若使用工作流工具，可考虑 cargo-release 将“改版本号→打标签→推送→发布”流程化。
• 建议在 CI 中跑 cargo audit（RustSec 漏洞审计）与 cargo deny（许可证/来源策略检查），并在发布前确保 Cargo.lock 已提交、构建与测试均通过。

四 Linux与工具链管理要点

• 使用 rustup 管理 Rust 工具链（稳定版/测试版/夜间版）、组件与多版本切换：例如 rustup install 1.85.0、rustup default 1.85.0、rustup update；确保 PATH 包含 $HOME/.cargo/env。
• 在团队协作中，结合 Git 分支策略（如 GitHub Flow/Git Flow）、代码格式化与静态检查（如 rustfmt、clippy）与持续集成，保障版本发布的一致性与质量。

五 常用命令清单

• 版本与标签
  • 查看/切换工具链：rustup show；rustup default ；rustup update
  • 打标签并推送：git tag -a v0.1.0 -m “msg”；git push --tags
• 依赖与锁文件
  • 添加依赖：编辑 Cargo.toml（如 serde = “1.0” 或 { version = “1.0”, features = [“derive”] }）
  • 升级：cargo update；cargo update -p regex；cargo update -p regex --precise 1.8.3
  • 依赖树：cargo tree；cargo tree -d（重复依赖）；cargo tree -e features
• 可复制构建与离线
  • 离线源码化：cargo vendor；在 .cargo/config.toml 中配置 source 指向本地 vendor
• 发布与审计
  • 预检与发布：cargo publish --dry-run；cargo publish
  • 安全合规：cargo audit；cargo deny