Pinia 状态管理:从 store 到持久化
当同一份状态被多个页面、多个组件同时使用时,组件内状态就开始变得难以维护。Pinia 提供的是一个明确的共享边界。
什么时候需要 Pinia
- 跨页面共享的数据(用户信息、文章列表)
- 需要被多个不相关组件读取的状态
- 需要统一管理加载态、错误态的数据请求
- 需要在服务端与客户端之间序列化的状态
如果状态只在一个组件树内使用,props 或 provide/inject 往往更简单。
定义 store 的两种方式
Option Store 更接近 Vuex:
export const useCounterStore = defineStore('counter', {
state: () => ({ count: 0 }),
getters: { double: (state) => state.count * 2 },
actions: {
increment() {
this.count++
}
}
})
Setup Store 更接近组合式 API,类型推导更自然:
export const usePostsStore = defineStore('posts', () => {
const posts = ref<Post[]>([])
const loading = ref(false)
const error = ref('')
const total = computed(() => posts.value.length)
async function load() {
loading.value = true
error.value = ''
try {
posts.value = await fetchPosts()
} catch (e) {
error.value = e instanceof Error ? e.message : '加载失败'
} finally {
loading.value = false
}
}
return { posts, loading, error, total, load }
})
storeToRefs
直接解构 store 会丢失响应式,需要 storeToRefs:
const store = usePostsStore()
const { posts, loading } = storeToRefs(store)
const { load } = store // 方法可以直接解构
异步动作与错误状态
建议把「加载中」「错误」和「数据」放在同一个 store 中,避免页面各自维护一套布尔值。
const store = usePostsStore()
onMounted(() => store.load())
页面只负责展示,不负责推断请求状态。
持久化
Pinia 本身不提供持久化。常见做法是在插件中读写 localStorage:
pinia.use(({ store }) => {
const saved = localStorage.getItem(store.$id)
if (saved) store.$patch(JSON.parse(saved))
store.$subscribe((_mutation, state) => {
localStorage.setItem(store.$id, JSON.stringify(state))
})
})
注意:
- 只持久化真正需要跨会话保留的字段
- 敏感信息不要写入 localStorage
- SSR / SSG 场景下不能在模块顶层访问
window
组织建议
- 按业务域拆分 store,而不是按页面
- store 内只保留共享状态,局部状态留在组件
- 把请求、错误处理收敛到 action 中
- 命名保持「名词 + Store」,文件与 store id 一致
- 不要把 store 当成事件总线使用