Rust最小版本支持MSRV

在 Rust 生态中，MSRV (Minimum Supported Rust Version) 是指一个项目（或库）能够成功编译所需要的最低 Rust 编译器版本。

当你遇到 proc-macro2 报错要求 1.68 而你只有 1.56 时，这就是典型的 MSRV 冲突。

1. 为什么会发生 MSRV 冲突？

• 依赖自动升级：Cargo 默认会下载符合语义化版本（SemVer）要求的最新兼容包。例如 proc-macro2 = "1.0" 可能会解析到 1.0.106，而这个新版本可能调高了 MSRV。
• 生态演进：Rust 社区通常只维护较新的编译器版本。1.56（2021年发布）对于目前的 Rust 生态来说已经非常老旧了。

2. 如何声明和检查 MSRV？

• 在 Cargo.toml 中声明（1.56+ 支持）：
  toml

  [package]
  name = "my-project"
  version = "0.1.0"
  rust-version = "1.56" # 这就是声明该项目的 MSRV
  

  声明后，如果依赖包的 MSRV 高于此值，Cargo 理论上应尽量解析兼容版本（但在旧版本 Cargo 中此功能不完善）。
• 自动检查工具：
  安装 cargo-msrv 可以自动查出你的代码到底最低支持到哪个版本：

  cargo install cargo-msrv
  cargo msrv 

用法

• cargo msrv find或cargo msrv find --linear以找到当前工作目录中Cargo项目的MSRV。
• cargo msrv --path <dir> find以找到指定目录<dir>中Cargo项目的MSRV。
• cargo msrv find -- <command>将<command>用作兼容性检查，以判断Rust版本是否兼容。此命令应可以通过rustup作为rustup run <toolchain> <command>运行。
  • 示例：cargo msrv find -- cargo check --tests。
• cargo msrv verify以验证由crate作者指定的MSRV
  • crate作者可以使用'Cargo.toml'清单中的package.rust-version（Rust >=1.56）或package.metadata.msrv键来指定MSRV。有关更详细的说明，请参阅书籍。
• cargo msrv list以列出由其作者指定的依赖项的MSRV
• cargo msrv show以显示当前指定的MSRV

3. 如何在旧版 Rust (1.56) 环境下生存？

既然你遇到了 proc-macro2 的版本问题，你有两种路径：

A. 强行锁定依赖版本（不推荐）

你需要手动查找所有依赖包在 2021 年左右的版本，并使用 = 精确锁定：

toml

[dependencies]
proc-macro2 = "=1.0.60" 
quote = "=1.0.21"
syn = "=1.0.100"

注意：这会导致你无法使用任何现代的 Rust 特性或安全补丁。

B. 升级环境（正解）

Rust 1.56 是 Rust 2021 Edition 发布时的版本。目前的很多主流库（如 serde, tokio, anyhow）已经将 MSRV 提升到了 1.60~1.70。

• 如果是因为离线环境无法升级：请在联网机下载 Rust 离线安装包，拷贝到服务器安装。
• 如果是因为环境变量没生效：请务必修复 .bashrc 的 export 问题。

4. 关键提示

在 Rust 1.56 版本中，Cargo 的依赖解析逻辑还没有现在这么智能。如果你必须在旧版本上开发，严禁随意运行 cargo update，因为它会把所有依赖推到最新版，从而瞬间刷爆你的 MSRV 限制。

 

参考资料：

1.cargo-msrv