Vue / 系统课时

Store 组合与依赖关系

Store 组合与依赖关系

多个 Pinia Store 可以互相复用,但真正的风险是依赖方向失控:A 读取 B,B 又反向读取或修改 A,最终形成循环依赖和难以追踪的副作用。本课用单向依赖和上层编排建立可扩展的组合方式。

学习目标

  • 判断 Store 之间哪些依赖是合理的单向复用
  • 用上层业务 Store 编排多个领域 Store
  • 识别循环依赖和隐式跨 Store 修改并进行拆分

先把 Store 看成有向依赖图

一个 Store 可以读取另一个 Store,也可以调用它公开的 Action,但依赖方向最好保持单向。领域 Store 只管理自己的状态;跨领域流程由更高一层的工作流 Store 或组合函数发起,这样依赖关系会形成有向无环结构。

Pinia Store 单向依赖与循环依赖对比

判断依赖是否健康可以先问一个问题:如果删除上层业务流程,领域 Store 是否仍能独立表达自己的职责?如果答案是否定的,说明领域边界已经被流程逻辑侵入。

用单向依赖复用其他 Store

下面的片段示例依赖已经执行 app.use(createPinia()) 的 Vue 3 项目,并假设 /api/orders 可以接收订单请求。checkout 负责流程编排,session 与 cart 不反向依赖它,因此依赖方向始终一致。

ts
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 : '提交失败'
      }
    },
  },
})

预期结果

text
未登录: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 的组合能力很灵活,但企业项目需要把这种灵活性约束成清晰、单向、可追踪的依赖关系。

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

目录与阅读设置

阅读设置

17

记录一个想法

Store 组合与依赖关系

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

登录哪都通