状态管理（State）：全局数据共享

在 Tauri 应用中，Rust 后端的“状态管理”指的是如何在多个命令、模块或请求之间安全地共享数据。Tauri 内置了基于类型的状态管理器，让你能够以极低的成本实现全局数据共享，而无需引入额外的库。

什么是 State？

State 是 Tauri 提供的一种依赖注入机制：你可以将任意 Rust 类型注册为“全局状态”，然后在任何 #[tauri::command] 函数的参数中直接通过 State<'_, T> 获取它的只读或可变引用。所有访问自动受到 Mutex 或 RwLock 的保护，并发安全由 Tauri 替你保证。

如何使用

第一步：定义状态类型
通常你会用一个 struct 来封装需要共享的数据：

use std::sync::Mutex;

pub struct AppState {
    pub counter: Mutex<i64>,
    pub user_name: Mutex<String>,
}

第二步：注册到应用
在 main 函数中构建 Tauri 应用时，调用 .manage() 将该状态实例注入：

fn main() {
    tauri::Builder::default()
        .manage(AppState {
            counter: Mutex::new(0),
            user_name: Mutex::new("Guest".to_string()),
        })
        .invoke_handler(tauri::generate_handler![
            increment_counter,
            get_counter
        ])
        .run(tauri::generate_context!())
        .expect("启动失败");
}

第三步：在命令中访问
在任何命令函数中，添加 State<'_, AppState> 参数即可获得状态引用：

#[tauri::command]
fn increment_counter(state: State<'_, AppState>) -> Result<i64, String> {
    let mut counter = state.counter.lock().map_err(|e| e.to_string())?;
    *counter += 1;
    Ok(*counter)
}

#[tauri::command]
fn get_counter(state: State<'_, AppState>) -> Result<i64, String> {
    let counter = state.counter.lock().map_err(|e| e.to_string())?;
    Ok(*counter)
}

前端调用方式与普通命令完全一致：

const count = await invoke('increment_counter');
console.log(count); // 每次调用返回递增后的值

为什么要用 State？

避免全局变量：Rust 的全局可变变量（static mut）需要大量 unsafe 代码，而 Tauri State 将数据的所有权转移给了框架，由框架保证安全的共享访问。
线程安全：通过 Mutex（互斥锁）或 RwLock（读写锁）保护的数据，可以安全地在多线程环境中被多个命令同时访问。
自动生命周期管理：状态对象会与应用的生命周期绑定，应用关闭时自动销毁，无需手动清理。
可测试性：在单元测试中，你可以创建独立的 App 实例并注入测试状态，而无需启动整套前端。

多个状态的注册

你可以通过多次调用 .manage() 来注册多个不同类型的状态，Tauri 会根据类型自动区分：

.manage(DatabasePool { /* ... */ })
.manage(CacheStore { /* ... */ })
.manage(AppConfig { /* ... */ })

在命令中，只要参数类型匹配，就能精准获取：

#[tauri::command]
fn query_data(db: State<'_, DatabasePool>, cfg: State<'_, AppConfig>) -> String {
    // 同时使用数据库连接池和配置
}

进阶：使用 `RwLock` 提高并发读性能

如果你的状态读取远多于写入，将 Mutex 换成 RwLock 可以让多个命令同时读取数据而不相互阻塞：

use std::sync::RwLock;

pub struct AppState {
    pub settings: RwLock<Settings>,
}

注意事项

状态管理的对象必须在 .manage() 时已经完成初始化，且内部数据必须实现 Send + Sync（通常通过 Mutex 或 RwLock 满足）。
尽量避免在锁内执行耗时操作（如文件 I/O），否则会阻塞其他等待该锁的命令。
对于需要持久化的状态（如用户偏好），建议结合 Tauri 的 plugin-store 或自行实现文件读写，在应用退出前将状态写回磁盘。

一句话总结：Tauri 的 State 机制让你通过简单的 .manage() 和 State<> 参数，就能在 Rust 后端安全、方便地管理跨命令共享的全局数据，它既是全局变量的安全替代方案，也是实现应用级配置、会话信息、连接池等场景的首选方式。