Vue / 系统课时

Store 结构与类型推断

Store 结构与类型推断

本课用一个可运行的 Setup Store 展示 state、getter 与 action 的职责,并说明 TypeScript 在何处能够自动推断、何处需要显式声明类型。

学习目标

  • 能使用 defineStore 创建 Setup Store
  • 能区分 state、getter 与 action 的职责
  • 能判断哪些类型可推断,哪些类型应显式声明

Setup Store 的基本结构

Setup Store 使用组合式 API 描述状态。ref 通常承载可变 state,computed 表达由 state 派生的 getter,普通函数则作为 action 修改状态或编排业务流程。

下面是主示例。它依赖已经安装并挂载的 Pinia,可直接保存为 src/stores/session.ts。

ts
import { computed, ref } from 'vue'
import { defineStore } from 'pinia'

interface User {
  id: number
  name: string
}

export const useSessionStore = defineStore('session', () => {
  // null 无法推断出后续用户结构,因此显式声明联合类型
  const user = ref<User | null>(null)
  const loginCount = ref(0)

  const isLoggedIn = computed(() => user.value !== null)
  const displayName = computed(() => user.value?.name ?? '游客')

  function login(nextUser: User): void {
    user.value = nextUser
    loginCount.value += 1
  }

  function logout(): void {
    user.value = null
  }

  return {
    user,
    loginCount,
    isLoggedIn,
    displayName,
    login,
    logout
  }
})

预期结果

text
该模块通过 TypeScript 编译后会导出 useSessionStore。
user 的类型为 User | null,isLoggedIn 为布尔派生值,login 和 logout 为可调用 action。

这三个角色的边界应保持稳定:state 保存事实,getter 只做无副作用的派生计算,action 负责修改 state、校验参数或调用接口。不要在 getter 中发送请求,也不要让组件直接复制一份领域状态。

在组件中使用并验证

组件读取 state 和 getter 时应使用 storeToRefs,这样解构后仍能保持响应式;action 可以继续通过 Store 实例调用。

vue
<script setup lang="ts">
import { storeToRefs } from 'pinia'
import { useSessionStore } from '@/stores/session'

const session = useSessionStore()
const { user, loginCount, isLoggedIn, displayName } = storeToRefs(session)

function handleLogin(): void {
  session.login({ id: 1, name: 'Ada' })
}
</script>

<template>
  <p>当前用户:{{ displayName }}</p>
  <p>登录状态:{{ isLoggedIn ? '已登录' : '未登录' }}</p>
  <p>登录次数:{{ loginCount }}</p>
  <p v-if='user'>用户编号:{{ user.id }}</p>
  <button :disabled='isLoggedIn' @click='handleLogin'>登录</button>
  <button :disabled='!isLoggedIn' @click='session.logout()'>退出</button>
</template>

预期结果

text
初始显示:当前用户为“游客”,状态为“未登录”,登录次数为 0。
点击“登录”后:当前用户变为“Ada”,状态变为“已登录”,登录次数变为 1。
点击“退出”后:用户重新显示为“游客”,登录次数仍为 1。

实际页面样式由项目 CSS 决定,但状态变化应与上述结果一致。

类型推断的关键边界

ref(0) 会推断为数值状态,computed(() => user.value !== null) 会推断为布尔 getter,action 的返回类型通常也能从函数体得到。对于初始值为 null、空数组或结构尚不完整的对象,应显式提供泛型,避免得到过窄类型。

Store 返回的成员会成为公开 API;未写入 return 的变量和函数只在 Store 内部可见。企业项目中可利用这一点隐藏请求细节,只暴露稳定的业务动作。

常见错误

直接写 const { loginCount } = session 会丢失 state 的响应式连接,应改用 storeToRefs(session)。另一个常见问题是把 getter 当作可写字段;需要修改数据时,应调用 action 修改其依赖的 state。

本课总结

  • Setup Store 中,ref、computed 和函数分别承担 state、getter 和 action 的职责
  • TypeScript 能推断多数简单类型,但 null、空集合和不完整对象通常需要显式声明
  • 解构响应式状态时使用 storeToRefs,修改状态时通过 action 统一入口

下一课预告

下一课将从生命周期与共享范围出发,划分组件状态、页面状态、会话状态和领域状态,避免把所有数据都塞进 Pinia。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Store 结构与类型推断

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通