Rust 1.100 新特性详解:never type 历经十年五次尝试终获稳定

Rust · 版本发布 1.100

Rust 1.100 新特性详解:never type 历经十年五次尝试终获稳定

rustRust版本发布never-type内存分配器DropGuard

数据源:GitHub Releases + 官方博客 + HN

2026 年 11 月 12 日,Rust 团队正式发布 Rust 1.100.0 版本。本版本最核心的变更是 never type(!)在历经 10 年讨论与 5 次稳定化尝试后正式稳定,同时 Infallible 转为 ! 的类型别名,并相应调整了旧 Edition 的类型推导回退规则。此外,核心 Allocator API、作用域守卫 DropGuard、零大小类型构造函数 conjure_zst 获得稳定支持,Cargo 亦带来了未用依赖检查与依赖发布冷却期(min-publish-age)。笔者将在下文中梳理各项关键特性的具体改动、官方示例与升级注意事项。

never type(!)正式稳定与回退规则调整

解决什么问题: never type(在代码中写作 !)是 Rust 中的规范空类型(canonical uninhabited type),表示发散计算(diverging computation)——即计算永远无法产出任何正常值,其后续代码均不可达。在 Rust 语言中,return、break 以及 std::process::exit 等控制流终止表达式的类型均为 !。

由于不存在 ! 类型的合法值,Rust 允许从 ! 强制转换为任意类型(never-to-any coercion)。开发者此前可以在 match 或 if 的分支中利用这一机制,也可以在函数返回签名中书写 -> !。然而在 1.100 之前,语法不允许在任意位置显式使用 !(例如无法直接书写泛型参数 Result<T, !>)。

Rust 1.100.0 允许在任意类型位置显式书写 !。同时,标准库中的 core::convert::Infallible 变更为 ! 的类型别名,使所有历史遗留使用 Infallible 的 API 与 ! 全面兼容。

官方示例代码:

fn mrrrow(option: Option<u32>) {
    let value = match option {
        // `x` 类型为 `u32`
        Some(x) => x,
        // `return` 类型为 `!`,随后强制转换为 `u32`,
        // 从而使 `match` 顺利通过类型检查。
        None => return,
    };
    // ...
}

fn infallible_unwrap<T>(res: Result<T, !>) -> T {
    // 此前版本中不允许直接书写 `Result<_, !>`
    let Ok(v) = res;
    v
}

破坏性变更与兼容性影响: 为了允许修改 Infallible,官方在此次发布中引入了一项破坏性变更:在 2024 之前的 Edition(即 2015、2018 与 2021)中,将 “never type fallback”(never 类型回退)从 () 改为 !。2024 Edition 此前已完成该调整。该改动在极少数情况下可能影响代码(例如忽略了返回泛型类型参数的函数返回值时),并可能促使编译器将更多代码标记为不可达(unreachable)。若依赖项因此出现构建失败,更新依赖版本即可。

Allocator API 核心部分稳定

解决什么问题: 此前 Rust 标准库的堆分配数据结构(如 Vec 与 Box)严格绑定全局分配器,嵌入式系统或需要特定内存池管理的高性能场景无法直接复用标准库集合。

Rust 1.100.0 稳定了 allocator_api 的核心设计,正式引入 std::alloc::Allocator trait、std::alloc::Global 与 std::alloc::System,并为 Vec 与 Box 提供了基于自定义分配器的构造和拆解接口。该工作奠定了 “Allocators 1.0” 项目目标的基础。

官方稳定接口:

  • std::alloc::Allocator trait
  • Box::new_in、Box::from_raw_in、Box::from_non_null_in、Box::into_raw_with_allocator、Box::into_non_null_with_allocator、Box::allocator
  • Vec::new_in、Vec::with_capacity_in、Vec::from_raw_parts_in、Vec::from_parts_in、Vec::into_raw_parts_with_allocator、Vec::into_parts_with_allocator、Vec::allocator

官方示例代码:

use std::alloc::{Allocator, Global};

fn demo_custom_allocator() {
    // 使用指定的分配器构造 Box 与 Vec
    let boxed: Box<i32, Global> = Box::new_in(42, Global);
    let mut vec: Vec<i32, Global> = Vec::with_capacity_in(10, Global);
    vec.push(*boxed);

    // 获取当前容器关联的分配器引用
    let alloc: &Global = vec.allocator();
    let _ = alloc;
}

core::mem::DropGuard:退出路径自动执行闭包

解决什么问题: 在 Rust 中,Drop trait 保证变量离开作用域时运行清理逻辑。但如果开发者仅仅希望在函数退出时无条件执行一段逻辑,通常需要单独定义临时结构体并实现 Drop。

Rust 1.100.0 引入了辅助类型 core::mem::DropGuard。它接收一个变量与一个闭包,实现了 Deref 与 DerefMut,使原变量的使用体验保持不变。当守卫离开作用域时,自动执行闭包并消费内部变量。

DropGuard 提供了关联函数 DropGuard::dismiss(为避免与内部类型的解引用方法产生命名冲突,特意设计为关联函数而非方法)。调用 DropGuard::dismiss 可安全取出内部变量,同时跳过析构闭包的执行。该机制非常适合构建事务式回滚操作。

官方示例代码:

use std::mem::DropGuard;
use std::num::ParseIntError;

/// 尝试解析全部 `strings` 并写入 `nums`。
/// 若任意一项解析失败,`nums` 保持原有内容不变。
fn parse_all(nums: &mut Vec<u32>, strings: &[&str]) -> Result<(), ParseIntError> {
    let len = nums.len();
    let mut nums = DropGuard::new(nums, move |nums| {
        nums.truncate(len);    // 1. 若中途失败,重置 Vec
    });

    for s in strings {
        nums.push(s.parse()?); // 2. 若 `?` 返回错误,触发回滚
    }

    DropGuard::dismiss(nums);  // 3. 解析顺利完成,解除守卫
    Ok(())
}

core::mem::conjure_zst:规范化构造零大小类型

解决什么问题: 在 unsafe 代码中,开发者常需要构造零大小类型(Zero-Sized Types, ZST)的值。过去社区普遍使用 transmute(()) 或 MaybeUninit::uninit().assume_init() 等写法,缺乏官方语义保证。

Rust 1.100.0 提供了专用的不安全函数 core::mem::conjure_zst。当确定类型大小为零且安全前置条件满足时,该函数提供了标准合法的构造途径。

许多 API 将零大小类型用作安全状态标记(例如 PyO3 中代表持有全局解释器锁 GIL 的 Python<'py> 标记),任意凭空生成此类标记会破坏库函数的安全假设,因此 conjure_zst 声明为 unsafe 函数。

官方示例代码:

use core::mem::conjure_zst;

#[derive(Debug, PartialEq, Eq)]
struct UnitToken;

fn get_token() -> UnitToken {
    // SAFETY: UnitToken 明确为零大小类型,且不包含内部安全约束
    unsafe { conjure_zst::<UnitToken>() }
}

Cargo 新增未使用依赖检查与构建缓存优化

解决什么问题: 项目中残留的未用依赖会增加编译开销。此前 rustc 的 unused_crate_dependencies lint 在 Cargo 多目标项目中易产生误报。

Rust 1.100.0 为 Cargo 引入了独立的 lint 系统,通过 Cargo.toml 中的 [lints.cargo] 控制。默认开启 cargo::unused_dependencies = "warn",在构建覆盖所有目标时报告未使用的依赖。该警告仅在构建所有可能使用该依赖的目标时触发,不对 [dev-dependencies] 报告。

同时,Cargo 改进了构建目录结构(Reducing Cargo cache collisions):构建目录按构建步骤组织,并将配置哈希移至父目录,减少了不同特性开关与 git worktrees 间的缓存冲突与重复编译。

官方示例与诊断输出:

warning: unused dependency `tracing-subscriber`
  --> Cargo.toml:23:1
   |
23 | tracing-subscriber.workspace = true
   | ^^^^^^^^^^^^^^^^^^
   |
   = note: `cargo::unused_dependencies` is set to `warn` by default
help: consider removing the dependency on `tracing-subscriber`

Cargo min-publish-age 依赖发布冷却期

解决什么问题: 开源供应链攻击往往在恶意版本发布后的数小时或数天内被生态监测发现。Rust 1.100 实现了 RFC 3923,为 Cargo 带来了 min-publish-age(依赖发布冷却期)机制。

开发者可在 .cargo/config.toml 中配置全局最小发布时长:

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

启用后,cargo update 解析依赖时会自动跳过发布时间短于设定窗口的版本,并将保留信息打印在终端:

$ cargo update
    Updating crates.io index
     Locking 2 packages to highest compatible version as of min-publish-age
      Adding cc v1.11.0 (available: v1.18.0, published 3 hours ago)
      Adding clap 4.6.7 (available: 4.6.9, published 2 days ago)

如需针对单次命令跳过冷却期,可使用环境变量覆盖:

CARGO_RESOLVER_INCOMPATIBLE_PUBLISH_AGE=allow cargo update clap --precise 4.6.9

核心稳定 API 清单

除上述重大特性外,Rust 1.100.0 还稳定了一批基础库接口:

API功能说明
str::trim_prefix / str::trim_suffix移除字符串的指定前缀或后缀切片
[T]::trim_prefix / [T]::trim_suffix移除切片的指定前缀或后缀子切片
Path::trim_prefix移除路径中的指定前缀路径
Vec::from_fn依据给定的生成闭包构造动态数组
UnsafeCell::replace安全替换内部值并返回旧值
UnsafeCell::as_ref_unchecked / as_mut_unchecked获取内部值的不可变与可变引用
bool::toggle原位翻转布尔值状态
Box::take / Box::map提取内部值或对堆上对象执行映射转换
Rc::map / Arc::map针对引用计数指针执行内部值映射转换

升级建议

笔者整理了针对不同团队的升级建议表,供升级规划参考:

适用团队推荐时机注意事项
基础库与公共 crate 维护者建议立即升级验证排查 2015/2018/2021 Edition 代码中的类型推导变动,确保 Infallible 转为 ! 别名后构建与测试无破坏。
高性能计算与系统底层团队建议逐步评估引入评估 std::alloc::Allocator 接入自定义内存池;排查 unsafe 代码中构造 ZST 的旧写法,换用 conjure_zst。
业务系统与通用开发团队建议平稳按部升级直接执行 rustup update stable 即可完成升级。可在 CI/CD 或本地配置 global-min-publish-age 防御供应链风险。

参考来源