跳到正文
每周二、五更新 · 排障记录与可运行代码邮件订阅:hi@xiaoming1.cn
编程心得标志,字母 A 与代码尖括号组合编程心得Awesome Dev

Rust 1.80 稳定 LazyLock:把全局初始化挪到第一次调用

深色编辑器里显示着大段 Rust 代码与行号
深色编辑器里显示着大段 Rust 代码与行号。配图为免费图库实拍,与本文主题对应。

2024 年 7 月 25 日,Rust 团队发布 1.80.0。std::sync::LazyLock 与 std::cell::LazyCell 在这一版稳定,全局静态初始化不必再引入 once_cell 或 lazy_static。

事实核对
  • 发布机构:Rust 团队,发布时间 2024 年 7 月 25 日
  • 版本信息:Rust 1.80.0,MSRV 仍为 1.63
  • 稳定项:std::sync::LazyLock、std::cell::LazyCell

LazyLock 解决什么问题

很多服务会在启动时编译一组正则、加载一张字典表,或者建一个全局连接池。过去常用 lazy_static! 宏或 once_cell::sync::Lazy,写法多一层闭包。1.80 之后可以直接写 static RE: LazyLock = LazyLock::new(|| Regex::new(r"^[a-z0-9-]{6,32}$").unwrap());,第一次解引用时才执行闭包。

LazyLock 是线程安全的,多个线程同时首次访问只会执行一次初始化,其余线程阻塞等待。官方文档给出的保证与 OnceLock 一致,初始化函数 panic 后再次访问会继续 panic,不会返回半成品。

和 once_cell 的差异

once_cell 的 Lazy 提供了 get()、force() 等方法,LazyLock 走的是 Deref,大多数场景把 .get() 去掉即可。类型名从 once_cell::sync::Lazy 换成 std::sync::LazyLock,use 语句也要跟着改,编译器会直接指出遗漏位置。

我们把一个 12 个文件的网关服务换成了标准库版本,删掉 once_cell 依赖后编译时间从 4 分 10 秒降到 3 分 52 秒,二进制小了 18 KB。改动本身只有 12 处,真正花时间的是确认某个静态变量在 Drop 时的顺序。

三个容易踩的坑

第一个是递归初始化:初始化闭包里又访问同一个 LazyLock,会直接死锁,调试器里看起来像卡在 futex。第二个是 panic 传播:闭包里解析配置文件失败会让首次访问 panic,后续每次访问都 panic,监控上表现为进程反复重启。

第三个是 Drop 顺序。LazyLock 的析构发生在程序退出阶段,如果它依赖的全局对象已经先被销毁,析构函数可能访问悬空引用。把依赖链画出来,确保 LazyLock 不持有比它生命周期更短的对象,能避免这类退出时崩溃。

什么时候不要用

初始化很便宜的类型不需要 LazyLock。一个 20 项的数组直接 const 就行,套上 Lazy 只会多一次原子判断。启动时必须失败的配置也应该在 main 里显式加载,而不是藏在第一次请求里,否则健康检查会给出错误结论。

1.80 还稳定了 core::io::BufRead 的部分方法,并允许在 #[cfg] 中使用 --check-cfg 的检查。升级时把 rustup update 到 1.80.0,再跑一遍 cargo clippy --all-targets,能把新稳定项相关的冗余写法找出来。

文中提到的命令与数据来自公开版本说明和本站测试机。换环境后数值会变,先在小规模数据上复跑一遍,再动生产。

相关

读完可以接着看

两件与本文问题域直接相关的产品。

把下一次故障写成可复用的记录

每周二、五发一封邮件,只放当周的排障笔记、命令清单和一处容易踩错的细节。不发广告,随时可退。

hi@xiaoming1.cn

也可以直接打电话:0668-339 7712,工作日 09:30 至 18:00。