鸿蒙全局状态管理最佳实践（AppStorageV2+@AppStorage+@StorageLink）
这套方案适配HarmonyOS 4.x+/ArkTS，兼顾全局共享、响应式 UI、持久化存储、跨场景调用，解决开发中「组件通信、页面共享、数据持久化、非 UI 逻辑取数」所有核心问题，面试可背、项目直接复用。
核心设计思路：以 AppStorageV2 为全局状态底层核心，@AppStorage 做组件内响应式包装，@StorageLink 实现关键数据持久化，三者联动形成「全局内存 + 组件响应 + 本地持久」的完整状态体系。
一、核心角色分工（牢记！）
先明确三者在方案中的精准定位，避免混用导致的性能问题或逻辑混乱：
| 技术 | 核心角色 | 响应式 | 持久化 | 适用场景 | 操作方式 |
|---|---|---|---|---|---|
| AppStorageV2 | 全局状态底层存储核心 | ❌ 否 | ❌ 否 | 非 UI 逻辑取数（工具类 / 网络 / 服务） | 手动get/set |
| @AppStorage | 组件内响应式包装器 | ✅ 是 | ❌ 否 | 组件 / 页面 UI 绑定、全局临时状态 | 装饰器声明直接用 |
| @StorageLink | 全局状态持久化包装器 | ✅ 是 | ✅ 是 | 需持久化的核心全局数据 | 装饰器声明直接用 |
关键联动规则
- @AppStorage/@StorageLink 底层均基于 AppStorageV2，三者操作同一套全局 key 池，数据互通；
- 持久化优先级：@StorageLink 声明的 key，会自动同步到本地 Preferences，AppStorageV2/@AppStorage 取该 key 时，优先读取本地持久化数据；
- 响应式触发：无论通过 AppStorageV2 还是 @StorageLink 修改 key，所有组件内 @AppStorage/@StorageLink 绑定该 key 的变量，都会自动刷新 UI。
二、项目落地架构（分层设计，高可维护）
按 **「全局常量→工具类封装→组件 / 页面使用→非 UI 逻辑使用」** 分层，避免硬编码 key、统一状态操作入口，适配中大型项目。
步骤 1：定义全局状态 Key 常量（统一管理，避免冲突）
创建common/constant/StorageKey.ets，集中管理所有全局状态的 key，杜绝魔法字符串，方便后期维护和批量修改。
// 全局存储Key常量，按业务模块分类 export class StorageKey { // 用户模块 static readonly USER_TOKEN = "user_token"; // 用户登录token（需持久化） static readonly USER_INFO = "user_info"; // 用户信息（需持久化） static readonly IS_LOGIN = "is_login"; // 登录状态（需持久化） // 应用配置模块 static readonly NIGHT_MODE = "night_mode"; // 夜间模式（需持久化） static readonly FONT_SIZE = "font_size"; // 字体大小（需持久化） // 临时全局状态（无需持久化） static readonly GLOBAL_LOADING = "global_loading"; // 全局加载状态 static readonly SEARCH_KEY = "search_key"; // 全局搜索关键词 }步骤 2：封装全局状态工具类（统一操作入口，简化调用）
创建common/utils/StorageUtil.ets，基于AppStorageV2封装所有全局状态的get/set/remove方法，组件、工具类、网络层均通过该工具类操作全局状态，屏蔽底层实现，降低耦合。
import { AppStorageV2 } from '@ohos.data.storage'; import { StorageKey } from '../constant/StorageKey'; // 全局状态工具类：基于AppStorageV2封装，所有非UI逻辑通过此类操作全局状态 export class StorageUtil { // =============