Debian系统上Rust如何进行版本控制

Debian 上 Rust 的版本控制实践

一 推荐方案 Rustup 工具链管理

• 安装与初始化：使用官方脚本安装 Rustup（Rust 官方工具链管理器），执行命令：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh，安装后执行 source $HOME/.cargo/env 使环境变量生效。验证安装：rustc --version、cargo --version。
• 日常升级与回退：全局升级到最新稳定版：rustup update；安装或切换到特定版本：rustup install <version>（如 1.70.0、nightly）；设置默认版本：rustup default <version>；查看已安装工具链：rustup toolchain list；临时覆盖版本：cargo +<version> build。
• 多版本并存与隔离：为不同项目指定不同工具链，推荐在项目根目录创建 rust-toolchain.toml（或 .rustup/toolchain 文件），内容示例：[toolchain] channel = "1.70.0" 或 nightly。进入项目目录时会自动切换到指定工具链，避免相互影响。

二 项目级与全局配置

• 项目级工具链与构建参数：使用 rust-toolchain.toml 固定工具链版本，必要时在 Cargo.toml 中设置 [profile]（如 dev/release）以控制优化与调试信息，实现构建可重复性与版本一致性。
• 全局与本地 Cargo 配置：全局配置位于 ~/.cargo/config.toml，可用于设置默认目标、镜像源、构建脚本行为等；项目级配置放在项目根目录的 Cargo.toml。常见做法是将常用组件（如 rustfmt、clippy）安装为全局组件，便于统一代码风格与静态检查：rustup component add rustfmt clippy。

三 与 Debian 系统包的关系

• 系统仓库安装方式：Debian 也提供 rustc/cargo 的系统包（通过 apt 安装）。此方式由发行版打包与版本冻结，适合系统级统一环境，但灵活性与更新速度不及 Rustup。
• 混用建议：若已用 Rustup 管理工具链，通常不建议再混用 apt 升级 rustc/cargo，以免 PATH 与版本冲突；如必须保留系统包，可将 ~/.cargo/bin 置于 PATH 的优先位置，确保使用 Rustup 工具链。

四 常用命令速查