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 当成事件总线使用