Rust 全局状态管理:lazy_static、once_cell 和 Arc 的组合用法对比

Qdrant 深度拆解:35K Star 的 Rust 向量数据库,是如何把 HNSW、Payload 过滤和量化压缩揉成一台机器 Qdrant 是基于 Rust 构建的向量数据库,以高效协同稠密向量(HNSW)、Payload 过滤与量化索引著称。其核心优势在于三者在查询中同步生效,兼顾召回率与性能。适用于 RAG、语义搜索、推荐系统及多租户场景,但不擅长事务或精确检索。架构分层清晰,写入经 WAL 保障一致性,检索通过分片与段并行加速。关键技术包括过滤感知 HNSW、ACORN 跨跳搜索、八类 Payload 索引、四档量化(如 TurboQuant、Product)及灵活多租户策略。最新版本 v1.20.1 强化了嵌套索引与重打分 阅读详情

Rust 全局状态管理:lazy_static、once_cell 和 Arc 的组合用法对比

一、Rust 为什么没有"普通"的全局变量

在 Python 或 Go 里,定义一个全局变量就跟喝水一样简单:

# Python: 全局变量就是这么自然
GLOBAL_CONFIG = load_config()
DB_POOL = create_pool()

但在 Rust 里你这么写,编译器会直接怼你。根本原因在于 Rust 的所有权模型:全局变量必须是 'static 生命周期的,而且在多线程环境中必须是 Send + Sync 的。普通的 let 绑定做不到这点。

二、lazy_static —— 老牌方案,简单但不完美

lazy_static 是我最早学会的全局状态方案。它的 API 很直观:用宏声明一个变量,提供一个初始化闭包,首次访问时才初始化。

use lazy_static::lazy_static;
use std::collections::HashMap;
use std::sync::Mutex;

// 定义全局配置映射表
lazy_static! {
    // 用 Mutex 包裹实现内部可变性
    // 注意:lazy_static 生成的变量是 &'static 引用
    static ref CONFIG: Mutex<HashMap<String, String>> = {
        let mut map = HashMap::new();
        map.insert("db_host".to_string(), "10.0.1.50".to_string());
        map.insert("db_port".to_string(), "5432".to_string());
        map.insert("redis_host".to_string(), "10.0.1.51".to_string());
        Mutex::new(map)
    };
}

fn main() {
    // 首次访问时才初始化,之后直接返回引用
    let mut config = CONFIG.lock().unwrap();
    println!("DB Host: {}", config.get("db_host").unwrap());
    
    // 运行时修改配置(比如从配置中心刷新)
    config.insert("db_password".to_string(), "new_password".to_string());
}

lazy_static 的好处是语法简洁,坏处也很明显:它依赖一个较重的宏,生成的代码可读性不高,而且获取的值是 &'static 引用,如果你想在运行时动态替换这个全局对象(比如重新加载配置),几乎不可能。另外,lazy_static! 宏要求你用 static ref 语法声明,这个 ref 会让人误以为它也是 Rust 的引用语法,实际上它只是个宏约定。

在 2024 年之前,lazy_static 几乎是 Rust 全局状态管理的唯一选择。但现在有了更好的替代方案。

三、once_cell / OnceLock —— 标准化的懒初始化

once_cell crate 和 std::sync::OnceLock(Rust 1.80+)提供了类似的懒初始化能力,但 API 更现代:你不需要宏,直接用普通的结构体和方法就行。

use std::sync::OnceLock;
use std::collections::HashMap;

/// 全局配置管理器(使用 OnceLock)
/// Rust 1.80+ 的标准库就支持,不需要额外依赖
static GLOBAL_CONFIG: OnceLock<AppConfig> = OnceLock::new();

/// 应用配置结构体
#[derive(Debug, Clone)]
struct AppConfig {
    db_host: String,
    db_port: u16,
    redis_url: String,
    max_connections: u32,
}

impl AppConfig {
    /// 从环境变量加载配置
    fn from_env() -> Self {
        Self {
            db_host: std::env::var("DB_HOST")
                .unwrap_or_else(|_| "localhost".to_string()),
            db_port: std::env::var("DB_PORT")
                .ok()
                .and_then(|p| p.parse().ok())
                .unwrap_or(5432),
            redis_url: std::env::var("REDIS_URL")
                .unwrap_or_else(|_| "redis://localhost:6379".to_string()),
            max_connections: std::env::var("MAX_CONNS")
                .ok()
                .and_then(|c| c.parse().ok())
                .unwrap_or(100),
        }
    }
}

/// 初始化全局配置(应该在 main 函数开头调用一次)
fn init_config() -> &'static AppConfig {
    GLOBAL_CONFIG.get_or_init(|| {
        println!("正在加载全局配置...");
        let config = AppConfig::from_env();
        eprintln!("配置已加载: {:?}", config);
        config
    })
}

fn main() {
    // 第一次调用会执行初始化闭包
    let config = init_config();
    println!("数据库地址: {}:{}", config.db_host, config.db_port);
    
    // 后续调用直接返回已有值
    let config2 = init_config();
    assert_eq!(config as *const _, config2 as *const _); // 同一个引用
}

对比表格总结一下:

特性lazy_static!once_cell::sync::OnceCellstd::sync::OnceLock
依赖第三方 crate第三方 crate(2024年后可移除)标准库(1.80+)
语法宏,static ref普通函数调用普通函数调用
可读性一般好好
泛型支持有限完整完整
动态替换不支持不支持(需要配合其他方案)不支持

如果项目用的是 Rust 1.80 以上,直接用 std::sync::OnceLock,不要再引入依赖了。如果是老项目对 once_cell 有依赖,也建议逐步迁移到标准库方案。

四、Arc + RwLock —— 当全局状态需要动态更新时

OnceLock 的问题是它只能"一次性"初始化——设好之后就不能改了。但在很多场景下,全局状态需要运行时更新,比如从配置中心热加载配置、重连断开的数据库连接池等。这时候 Arc + RwLock 的组合就成了更好的选择。

use std::sync::{Arc, RwLock};
use anyhow::Result;

/// 使用 Arc<RwLock<>> 实现可更新的全局状态
/// 对比 OnceLock 方案,这个方案支持运行时替换配置

pub struct GlobalState {
    /// 数据库连接池(可动态替换)
    db_pool: Arc<RwLock<Option<sqlx::PgPool>>>,
    /// 运行时配置(可从配置中心热更新)
    runtime_config: Arc<RwLock<RuntimeConfig>>,
}

/// 运行时配置(区别于启动时的一次性配置)
#[derive(Debug, Clone)]
pub struct RuntimeConfig {
    pub log_level: String,
    pub rate_limit_qps: u32,
    pub feature_flags: std::collections::HashSet<String>,
}

impl GlobalState {
    /// 创建全局状态实例
    pub fn new() -> Self {
        Self {
            db_pool: Arc::new(RwLock::new(None)),
            runtime_config: Arc::new(RwLock::new(RuntimeConfig {
                log_level: "info".to_string(),
                rate_limit_qps: 1000,
                feature_flags: std::collections::HashSet::new(),
            })),
        }
    }

    /// 初始化数据库连接池
    pub async fn init_db(&self, database_url: &str) -> Result<()> {
        let pool = sqlx::postgres::PgPoolOptions::new()
            .max_connections(50) // 连接池大小
            .connect(database_url)
            .await?;
        
        let mut db = self.db_pool.write().unwrap();
        *db = Some(pool);
        Ok(())
    }

    /// 热更新运行时配置
    /// 读取时不阻塞写入,写入时短暂阻塞其他写入者
    pub fn reload_config(&self, new_config: RuntimeConfig) {
        let mut config = self.runtime_config.write().unwrap();
        *config = new_config;
        println!("运行时配置已热更新");
    }

    /// 获取当前配置的快照(读取操作不阻塞其他读取者)
    pub fn get_config(&self) -> RuntimeConfig {
        self.runtime_config.read().unwrap().clone()
    }

    /// 检查某个功能标志是否启用
    pub fn is_feature_enabled(&self, flag: &str) -> bool {
        let config = self.runtime_config.read().unwrap();
        config.feature_flags.contains(flag)
    }
}

// 全局单例
use std::sync::OnceLock;
static GLOBAL_STATE: OnceLock<Arc<GlobalState>> = OnceLock::new();

/// 获取全局状态(懒初始化)
pub fn global_state() -> &'static Arc<GlobalState> {
    GLOBAL_STATE.get_or_init(|| Arc::new(GlobalState::new()))
}

这就是一个典型的"组合拳":OnceLock 持有 Arc,Arc 内部是 RwLock——OnceLock 保证全局唯一,Arc 保证多线程安全共享,RwLock 保证运行时可变。这套模式在 Rust 中非常常见,它的本质是用类型系统替代了传统语言中的"全局可变变量"概念。

实际使用时需要注意:RwLock 的读锁和写锁是互斥的,如果你的读操作特别频繁而写操作极少,RwLock 比 Mutex 性能好很多。但如果你的读写比接近 1:1,Mutex 反而更简单高效。这个判断取决于具体的业务场景。

五、总结

Rust 的全局状态管理有三种主流方案:lazy_static! 宏适合旧项目和快速原型(但建议迁移),OnceLock/OnceCell 是标准化懒初始化的最佳选择(Rust 1.80+ 直接用标准库),Arc + RwLock 适合需要运行时动态更新状态的场景。实际项目中经常把它们组合使用:OnceLock<Arc<RwLock<T>>>。

从的角度看,Rust 这种"让你显式表达意图"的风格一开始确实很劝退——凭什么我定义一个全局变量要写 5 行代码?但用的越久,越明白这种设计背后的价值观:在编译期就把潜在的并发问题暴露出来。Python 的全局变量改了就能用,但它永远不会告诉你哪个线程在同时改这个变量。


simulink的Sine Wave 模块详解 模块是 Simulink 中的一个信号源模块,用于生成正弦波信号。该模块可以根据设定的幅值、频率、相位和偏移量,在仿真过程中产生周期性的正弦波形。模块都能提供强有力的支持。通过深入了解其参数的影响及结合 MATLAB 脚本的应用,读者可以更加有效地利用这一模块进行仿真和研究。此外,通过实际应用场景的扩展以及常见问题解答部分的帮助,能够更好地掌握。模块是一个非常实用的工具,适用于需要生成正弦波信号的各种场景。模块的参数,可以进一步增强学习体验。模块参数的影响,下面我们将详细探讨每个参数如何影响仿真结果。 阅读详情

相关推荐

window安装TradingView

TradingView一些操作记录

m0_37967652的博客 1万+

组网第63课:安全域划分——Trust/Untrust/DMZ、区域模型、与 VLAN 的关系

一组接口 + 一组策略 + 一条默认拒绝。一组接口:这个域包含哪些物理口、VLAN、子接口;一组策略:这个域到别的域放行什么、拒绝什么;一条默认拒绝:没写进策略的,一律不通。第三条最关键。没有默认拒绝,前面划的域全是装饰。

qq_36765170的博客 572

OpenLayers源码解析1 Map.js

Map.js 父类:./PluggableMap/PluggableMap 引用:5个模块 ./renderer/Composite.js ./PluggableMap.js ./obj.js ./control.js(控件) ./interaction.js(交互) 主要功能:核心组件,渲染地图 必要参数: view layers target controls和interactions要是未指定,使用默认值 方法:createRenderer()? /** * @module ol/Map */ i

qq_45005996的博客 1899

rust: Fan-out/Fan-in Pattern

本项目基于Rust实现珠宝行业全流程的扇出/扇入模式,采用DDD六层架构。通过ProcessRequestDto与ProcessResponseDto传输数据,将采购、设计、生产等12个业务阶段抽象为可并行执行的FanoutTask子任务。核心由JewelryFanoutFanin实现并行调度:先扇出至12个线程并发执行,再统一扇入汇总结果。系统集成日志(文件+控制台)、重试熔断、内存仓储及依赖注入容器,支持顺序与并发两种调度方式,确保高并发下任务可靠执行与可观测性。

Geovin Du Dream Park 163

从零到一:手把手教你构建自定义ReaxFF力场参数

本文手把手教你从零构建自定义ReaxFF力场参数,详解反应力场的动态键序机制与参数化逻辑。通过LAMMPS实战演示,涵盖训练数据准备、参数优化算法选择及性能优化技巧,助力研究人员精准模拟化学反应过程。适用于材料科学、催化研究等领域,特别适合已掌握分子动力学基础的进阶用户提升力场开发能力。

weixin_28365523的博客 1060

0018-量化第五天:QMT—日内回转回测注释

日内做T算法框架

m0_68750710的博客 4149

Rust组织管理(AI回答)

你想做的事JS / Python 做法Rust 做法把一个文件纳入工程新建文件即可新建 xxx.rs 后,必须在入口写mod xxx;挂载对外暴露函数/结构体export(Python 默认全公开)默认全私有,必须显式加pub引入别处的函数use crate::模块名::函数名;找路径的基准词./ 或 ../(从 src 根出发)、(上一级 ../)、(当前级 ./)日常写项目:不要用 #[path],直接遵守默认规则——

yaoct的博客 153

基于SpringBoot+Vue的公司考勤管理系统

为什么选择我博主是优快云毕设辅导博客第一人兼开派祖师爷、博主本身从事开发软件开发、有丰富的编程能力和水平。专注于Java技术领域和学生毕业项目实战,高校老师/讲师/同行前辈交流和合作。

m0_71849512的博客 1164

自建 RustDesk 服务端后,做一个“装完就能连“的客户端

如果有云服务的话,可以基于 RustDesk 的 hbbs / hbbr 自己部署一套,不过会碰到一个问题:每台电脑装完客户端,都得手动去设置里填三样东西——ID 服务器、中继服务器、Key。填错一个就连不上,还得远程指导同事操作。这篇记录两种解决办法,以及云端编译的完整流程。内容基于 RustDesk 1.5.3 的源码。

风声的专栏 632

NX二次开发常用函数——从一个坐标系到另一个坐标系的转换(UF_MTX4_csys_to_csys )相同体坐标转化

本文介绍了在项目开发中实现坐标转换的方法,重点解析了两个关键函数UF_MTX4_csys_to_csys和UF_MTX4_vec3_multiply的使用。通过4个变换矩阵(transform1-4)实现工作坐标系与绝对坐标系之间的相互转换,并以圆柱体为例详细说明了坐标转换的具体实现过程,包括原点、X/Y轴方向的转换处理。相比之前采用的if-else判断方法,这种矩阵转换方式在代码复杂度和运行效率上都更具优势。

weixin_47753171的博客 600

[VCS]VCS编译及仿真时间分析及加速方法

本文介绍了VCS仿真工具中编译和仿真时间的分析方法及优化策略。首先阐述了使用-simprofile选项生成profileReport.html报告来定位时间消耗点的方法。其次提出了三种优化方案:优化resource_db/config_db使用wildcard、减少debug选项的影响、选择性dump fsdb波形。重点讲解了VCS checkpoint机制,详细说明了其保存/恢复仿真状态的功能、使用方法、与restart的区别,以及如何通过选择性保存、压缩、SSD存储等方式提升效率。最后提出将checkp

元直的博客 1万+

Rust LeetCode443 算法题解

LeetCode 443 字符串压缩:原地行程编码,用 start 标记组起点、next 扫描组边界、i 原地写出;长度 1 不写计数使编码不膨胀,写指针不越过读指针。时间 O(n),额外空间 O(1)。

weixin_43379230的博客 182

Statistics and Machine Learning Toolbox

Statistics and Machine Learning Toolbox(带书签),MATLAB统计学习工具

GitHub 热榜项目:日榜(2026-11-10)

本期共 11 个热门开源项目,合计新增 13,136 stars。榜单前三分别是 Anthropic 的 Agent Skills 仓库、Meta 开源的 React 设计系统 Astryx(+3,278)和用户名检索工具 sherlock(+4,267,本期涨星最多)。其余项目覆盖 DeepMind 的物理引擎 MuJoCo、Claude 官方示例集、自托管智能体记忆系统 GBrain、用 Rust 写的浏览器自动化 CLI、基于 WiFi 信号的人体感知平台 RuView、多市场股票分析工具,以及 Ho

u130130的博客 447

LinePhone3.2.7(android端最新版本) sip客户端

SIP客户端For android:LinePhone3.2.7(最新版本),官网地址:http://www.linphone.org/

锂电池充电器电路设计 里面有电路

锂电池充电器电路设计 里面有电路 3.7V升压到5V电路设计。

GitHub 今日推荐|HGhubX:Tauri 2 跨平台短剧客户端实战

Tauri 2 + Rust + React 构建的跨平台短剧观看客户端,实现 HLS 代理、AES 封面解密、多线路探测与会话隔离,覆盖桌面与移动全平台。

wfly blog 432

ARTCRAFT系列软件简单试用手记1

AI辅助开发推动开源重构热潮,ARTCRAFT系列以Rust重写经典软件,性能媲美C/C++。其Launcher支持多平台、多架构,可快速部署开源版Excel(GridCraft)与Word(WordCraft),启动速度远超Office 2016。界面类Office 2016,但暂不完善汉字字号与红头嵌套编辑。项目持续更新,主打“CraftAnything”理念——理解软件原理,自创版本,未来可期。

olegja3d的博客 213

Rust 日志追踪实战:工业边缘场景下的 tracing

Rust 生态下:相比println!log,它提供结构化字段、span 上下文、异步友好和 OpenTelemetry 集成。本文从工程实战角度梳理 tracing 的用法与常见的坑。

ZenovaEdgeOS的博客 561

Rust如何实现微服务网关的高并发与限流熔断机制

在现代互联网系统中,微服务架构已成为主流,而微服务网关则是整个系统的重要组成部分。当面对高并发、高可用性需求时,很多开发者对如何用 Rust 实现一个稳定可靠的网关存在疑惑,尤其是处理请求的幂等性、限流和熔断机制。本文将以 Rust 的实际案例为基础,结合生产环境中的具体经验,讲解如何设计和实现一个具备限流与熔断能力的微服务网关。

wuchangjian的专栏 115

第 1 讲:内存布局与所有权解剖——栈帧、胖指针与“移动/拷贝”在汇编层面的真实面目

看图最下面的(或者数组切片&[T]它在栈上占16 个字节,由(ptr, len)两个机器字组成。这就是系统编程里常说的胖指针(普通指针只有 8 字节地址,它胖了一倍,多带了一个 8 字节的长度或虚表指针)。痛点追问:C 语言里表示字符串切片只要一个 8 字节的char*,为什么 Rust 非要浪费双倍的栈空间搞成 16 字节?如果少掉len这一环会出什么乱子?回想一下 C 语言是怎么知道一个字符串在哪结束的:靠在内存末尾塞一个字节的\0求长度是 $O(N)$ 的苦力活:在 C 里调strlen(p)

yaoct的博客 168

【Rust算法硬核拆解】LeetCode 334 递增的三元子序列(贪心+O(1))

【LeetCode 334 递增的三元子序列】用一次扫描贪心实现:时间 O(n)、空间 O(1)。附 13 个单测与正确性说明。

weixin_43379230的博客 354

主流开源 LLM 网关横向评测:OneAPI、LiteLLM、NewAPI 能力对比

在大模型应用规模化落地的当下,多模型混用、API 密钥分散、成本不可控、接口不统一已成为开发者的普遍痛点。LLM 网关作为 AI 应用层与模型层之间的核心中间件,承担着协议转换、流量路由、成本管控、安全审计的关键作用。本文从协议许可、功能完备度、性能表现、生态适配四个核心维度,对业内主流的三款开源 LLM 网关 ——OneAPI、LiteLLM、NewAPI 进行深度横向评测,为不同规模的团队提供选型参考。

2601_96785163的博客 303

Rust 1.100 的 DropGuard:用 Python 实测失败回滚与吞异常

解析一批数据往列表里塞,塞到第三条抛异常,列表已经脏了一半——这类「能跑但结果不对」的 bug 不报错也不崩溃。Rust 1.100.0 把 core::mem::DropGuard 稳定了:包裹一个

aifannihao的博客 222

rust: Push & Pull Pattern

本项目基于Rust实现珠宝行业全流程的推-拉(Push&Pull)消息模式,采用领域驱动设计(DDD)六层架构。通过JewelryPushPullHub通道实现生产者推送与消费者拉取解耦,12个业务部门(如采购、设计、质检等)作为独立消费者,按供应链顺序串行或并发处理消息。系统集成重试熔断、线程安全日志(按日期/等级分文件)、内存仓储及依赖注入容器,确保高并发下流程可追溯、弹性可靠。演示涵盖串行调度、批量并发、端口契约调用等场景,完整呈现企业级消息型模式的核心能力。

Geovin Du Dream Park 117

我用 RustyPaste 做 AI Agent 云端存储

RustyPaste 是一个用 Rust 编写的极简文件上传与 Pastebin 服务。可以用来存储和访问 AI Agent 生成的文件

藏云阁技术社区 242

拆解 lan-scanner:一个零依赖 Rust 局域网扫描器的并发模型

lan-scanner 以零依赖实现高效局域网扫描,核心在于精巧的并发模型:通过懒加载任务队列(Jobs)避免内存爆炸,用 Arc<Mutex<Jobs>> 共享任务源,结合 mpsc 通道实现线程池并行探测。Probe 枚举统一 ICMP ping 与 TCP 端口扫描,跨平台差异由 #[cfg] 条件编译处理,调用系统 ping 命令规避权限问题。drop(tx) 优雅关闭通道,确保所有工作线程退出。全靠标准库完成高并发、低资源消耗的扫描,是 Rust 并发编程的典范。

weixin_63115449的博客 186

Cursor + IntelliJ IDEA = OpenIDEA?这个Rust开源IDE有点东西

是一个开源的集成开发环境(IDE),设计目标是在保留 IntelliJ IDEA 优秀开发体验的同时,通过原生架构实现更高性能、更低资源占用和更开放的生态。OpenIDEA 项目仍然处于快速发展阶段,插件生态和语言支持成熟度暂时还无法与 JetBrains 系列相比,暂时不建议立即替代生产环境。

Tony.Dong的专栏 468

工作流脚本和依赖 JAR 散在各节点本地盘:用 DolphinScheduler 资源中心接到 RustFS

DolphinScheduler 跑工作流,脚本、依赖 JAR、UDF 这些资源文件默认存在各节点的本地盘上。单机环境没问题,集群一扩节点、机器一换,资源就找不到了,依赖这些文件的任务也跟着挂。更麻烦的是,运维人员把资源传到 A 节点,调度器却在 B 节点拉起任务,缺文件只能手动再传一遍。DolphinScheduler 的资源中心(resource center)支持把存储后端切成 S3,每个…

分布式存储与RustFS的博客 353
上一篇: Tokio 在生产环境:日处理千万请求的异步服务怎么配置才稳妥
下一篇: WebAssembly 在 Serverless 中的应用:冷启动 10ms 的 AI 推理函数
第一程序员
博客等级 码龄1年 1万+粉丝 1827原创
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值