目录

2026年11月12日发布的 Rust 1.100.0 允许在更多位置使用 never 类型,并稳定了 Vec 和 Box 的自定义分配器 API。此外,Cargo 处理依赖的方式也有变化,在整个项目中升级前,还需检查一些兼容性变更。

要点#

  • never 类型 ! 可以用作类型参数,通过 Result<T, !> 等类型表达不会返回错误的操作。
  • 稳定后的分配器 API 允许为各个 Vec 或 Box 值指定自定义分配器。
  • Cargo 新增了未使用依赖警告,以及可选的等待期,用于延迟将新发布的包版本纳入候选范围。
  • 升级时,需要检查类型推断、检查构建产物的工具,以及 32 位 Windows 主机的使用情况。

用 ! 表示不可能发生的错误#

never 类型没有任何可能的值。Rust 此前已支持使用 -> ! 表示不会正常返回的函数的返回类型。在 1.100.0 版本中,它也可以用于类型参数等位置。

例如,Result<T, !> 表示一种操作:它可以返回类型为 T 的成功值,但不会产生错误值。这一保证在类型中得到了明确表达。此前用于这一目的的 Infallible 将成为 ! 的别名。

此外,Edition 2015、2018、2021 中 never 类型的回退类型将从 () 改为 !,与 Edition 2024 保持一致。部分现有代码可能因此编译失败或行为发生变化。如果类型推断变更导致问题,请添加显式类型注解。如果问题出在依赖中,请检查是否已有修复版本发布。

为每个值选择分配器#

稳定后的 Allocator trait 允许开发者定义内存分配和释放方式。通过 Vec::new_in 和 Box::new_in 等 API,可以为每个向量或装箱值选择自定义分配器。

当程序的不同部分需要采用不同的内存分配策略时,这会很有用。已经需要自定义分配器的项目,现在可以在稳定版 Rust 中使用这些 API。对其他集合类型和指针类型的支持仍在推进中。

由于部分 Box 的 trait 实现开始支持自定义分配器,现有代码也可能出现新的类型推断错误。在自行修改分配器之前,请先检查升级后的编译器诊断信息。

检查 Cargo 依赖#

Cargo 现在会对 Cargo.toml 中声明但被判定为未使用的依赖发出警告。cargo::unused_dependencies 警告属于新近稳定的 Cargo lint 系统,可在 [lints.cargo] 中设置其级别。

请逐项核查这些警告。检测范围因命令和构建目标而异,且不包括 dev-dependencies。某些发挥必要作用的依赖也可能被标记,因此请在删除前确认其添加原因。

Cargo 的安装行为也发生了变化。cargo install 现在默认使用包中附带的 Cargo.lock 所记录的依赖版本。如果包中没有锁文件,则照常解析依赖。请检查此前依赖于重新解析依赖的安装流程。

延迟采用新包版本#

Cargo 中已稳定的最短发布时间设置,可以排除尚未经过指定等待期的包版本。默认值为 "0",因此仅升级并不会启用等待期。

要将等待期设为 3 天,请在项目的 .cargo/config.toml 中添加以下内容。

snippet.txt
[registry]
global-min-publish-age = "3 days"

这一等待期可以在新版本被纳入候选范围前,为扫描工具和维护者留出时间,以发现部分恶意发布。但它并不保证旧包的安全性。请继续审查依赖更新,并在规划紧急修复时考虑等待期的影响。

检查清理逻辑和构建工具#

DropGuard 持有一个值和一个用于清理的闭包,并在守卫被丢弃时执行该闭包。无需专门定义实现 Drop 的类型,就能在提前退出时执行回滚。操作成功时,可以通过 DropGuard::dismiss 取出值,而不执行闭包。

此外,还新增了 Box::map、Vec::from_fn 和 unsafe 函数 conjure_zst。最后一个函数尤其需要谨慎使用。即使是零大小的值,也可能表示持有锁等与安全性有关的条件。不能因为大小为零,就认为可以安全地任意创建。

迁移时,请检查以下两项与运行维护有关的变更。

  • Cargo 现在使用包含构建配置哈希的目录名来隔离中间产物。请更新依赖旧目录布局的工具或测试。
  • 不再分发面向 i686-pc-windows-msvc 和 i686-pc-windows-gnu 的主机工具。请在受支持的主机上通过交叉编译构建 32 位 Windows 二进制文件。

下一步#

在升级分支中,使用 Rust 1.100.0 运行项目现有的完整 CI 测试套件,并在修改应用代码以使用新 API 之前,检查编译器错误和 Cargo 警告。

来源: https://gihyo.jp/article/2026/11/rust-1.100.0

目录