Rust 基础

本页面介绍在灵动桌面框架开发中最常用的 Rust 概念，示例均取自框架源码。

所有权与借用

Rust 最核心的特性，编译期保证内存安全：

// 借用（引用）— 不转移所有权
pub fn greet(name: &str) -> Result<String, CommandError> {
    Ok(format!("Hello, {}! 来自 Rust 的问候!", name))
}

Result 错误处理

框架中所有可能失败的操作都返回 Result，用 ? 向上传播错误（services/config.rs）：

pub fn get(db: &Database, key: &str) -> Result<String, AppError> {
    db.get_config(key)?  // ? 自动传播数据库错误
        .ok_or_else(|| AppError::NotFound(format!("配置项 '{}' 不存在", key)))
}

Option 转 Result 用 ok_or_else，把“查不到”变成明确的业务错误。

结构体

use serde::{Deserialize, Serialize};

/// 应用配置（models/mod.rs）
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AppConfig {
    pub key: String,
    pub value: String,
}

共享可变状态

Database 用 Mutex<Connection> 保证线程安全，加锁失败不 unwrap，而是转换成 AppError：

let conn = self.conn.lock().map_err(|e| AppError::Custom(e.to_string()))?;

类型对照表

常用 Crate