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。
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
}
})预期结果
该模块通过 TypeScript 编译后会导出 useSessionStore。
user 的类型为 User | null,isLoggedIn 为布尔派生值,login 和 logout 为可调用 action。这三个角色的边界应保持稳定:state 保存事实,getter 只做无副作用的派生计算,action 负责修改 state、校验参数或调用接口。不要在 getter 中发送请求,也不要让组件直接复制一份领域状态。
在组件中使用并验证
组件读取 state 和 getter 时应使用 storeToRefs,这样解构后仍能保持响应式;action 可以继续通过 Store 实例调用。
<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>预期结果
初始显示:当前用户为“游客”,状态为“未登录”,登录次数为 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。