Vue / 系统课时
Store 组合与依赖关系
Store 组合与依赖关系
多个 Pinia Store 可以互相复用,但真正的风险是依赖方向失控:A 读取 B,B 又反向读取或修改 A,最终形成循环依赖和难以追踪的副作用。本课用单向依赖和上层编排建立可扩展的组合方式。
学习目标
- 判断 Store 之间哪些依赖是合理的单向复用
- 用上层业务 Store 编排多个领域 Store
- 识别循环依赖和隐式跨 Store 修改并进行拆分
先把 Store 看成有向依赖图
一个 Store 可以读取另一个 Store,也可以调用它公开的 Action,但依赖方向最好保持单向。领域 Store 只管理自己的状态;跨领域流程由更高一层的工作流 Store 或组合函数发起,这样依赖关系会形成有向无环结构。

判断依赖是否健康可以先问一个问题:如果删除上层业务流程,领域 Store 是否仍能独立表达自己的职责?如果答案是否定的,说明领域边界已经被流程逻辑侵入。
用单向依赖复用其他 Store
下面的片段示例依赖已经执行 app.use(createPinia()) 的 Vue 3 项目,并假设 /api/orders 可以接收订单请求。checkout 负责流程编排,session 与 cart 不反向依赖它,因此依赖方向始终一致。
import { defineStore } from 'pinia'
type CartItem = {
sku: string
quantity: number
}
export const useSessionStore = defineStore('session', {
state: () => ({
userId: null as number | null,
}),
})
export const useCartStore = defineStore('cart', {
state: () => ({
items: [] as CartItem[],
}),
actions: {
clear() {
this.items = []
},
},
})
async function submitOrder(userId: number, items: CartItem[]) {
const response = await fetch('/api/orders', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ userId, items }),
})
if (!response.ok) {
throw new Error(`HTTP ${response.status}`)
}
}
export const useCheckoutStore = defineStore('checkout', {
state: () => ({
status: 'idle' as 'idle' | 'loading' | 'success' | 'error',
errorMessage: '',
}),
actions: {
async submit() {
const session = useSessionStore()
const cart = useCartStore()
if (session.userId === null) {
this.status = 'error'
this.errorMessage = '请先登录'
return
}
if (cart.items.length === 0) {
this.status = 'error'
this.errorMessage = '购物车为空'
return
}
this.status = 'loading'
this.errorMessage = ''
try {
const items = cart.items.map(item => ({ ...item }))
await submitOrder(session.userId, items)
cart.clear()
this.status = 'success'
} catch (error) {
this.status = 'error'
this.errorMessage =
error instanceof Error ? error.message : '提交失败'
}
},
},
})预期结果
未登录:checkout.status = "error",errorMessage = "请先登录"。
购物车为空:checkout.status = "error",errorMessage = "购物车为空"。
请求成功:checkout.status = "success",cart.items 被清空。
请求失败:checkout.status = "error",购物车仍保留,便于用户重试。实际用户 ID、商品数据和接口错误码属于动态值,日志或测试快照中应使用 <ID>、<VALUE> 等占位符表示。
避免循环依赖和隐式耦合
最危险的模式不是“一个 Store 使用另一个 Store”,而是双方都把对方当成自己的内部实现。例如购物车修改后直接操作结算状态,而结算 Store 又回头修改购物车,这会让一次状态变化跨越多个边界,调试时很难定位真正的写入者。
更稳妥的约束是:一个状态只由一个 Store 拥有;其他 Store 通过公开 Action 请求变更,不直接承担它的业务规则;需要同时协调三个以上 Store 时,把流程放到上层编排,而不是继续增加横向互相调用。
把跨领域流程放到上层
当一个操作天然跨越登录、购物车、优惠、库存和订单等多个领域时,可以新增工作流 Store 或组合函数,让它成为唯一的协调入口。领域 Store 只暴露稳定能力,例如 clear()、reserve()、refresh(),而不需要知道是谁调用它们。
这种结构的判断标准不是“Store 越少越好”,而是依赖能否沿一个方向解释清楚。只要能从调用入口一路向下追踪到领域 Store,并且不存在反向回路,测试、替换和故障定位都会简单很多。
检查依赖是否健康
交付前可以检查三件事:同一份状态是否存在多个写入者;领域 Store 是否为了完成一次流程而直接修改另一个领域的内部字段;依赖图中是否能从某个 Store 沿调用关系再次回到它自己。
出现任一情况,都应优先拆分职责或提升编排层级,而不是继续增加互相调用。Pinia 的组合能力很灵活,但企业项目需要把这种灵活性约束成清晰、单向、可追踪的依赖关系。