Pinia 的“多个 Store”指同一实例下通过 defineStore 创建多个 ID 唯一的独立状态单元，而非多个 Pinia 实例；每个 Store 拥有封闭的 state、getters、actions，通过唯一 ID 隔离作用域，天然互不影响。
Pinia 本身不提供“多个 Store 实例”的运行时隔离机制，它的设计哲学是单实例 + 多 Store 定义。所谓“多个 Store”，指的是在同一个 Pinia 实例下，通过 defineStore 创建多个逻辑独立、ID 唯一的 Store 函数，每个函数调用后返回一个具备自身状态和行为的响应式对象。这不是多个 Pinia 实例，而是多个 Store —— 它们天然作用域隔离，互不影响。
每个 Store 是独立的作用域单元
- Store ID（如
'user'、'cart'）是全局唯一标识，Pinia 内部用它做缓存与查找。 - 每个 Store 的
state、getters、actions都封闭在其函数作用域内，彼此不共享数据或逻辑。 - 即使两个 Store 都叫
useCartStore，只要 ID 不同（比如'cart-a'和'cart-b'），它们就是完全独立的状态容器。
// stores/cartA.ts
export const useCartA = defineStore('cart-a', {
state: () => ({ items: [] })
})
// stores/cartB.ts
export const useCartB = defineStore('cart-b', {
state: () => ({ items: [] })
})组件中分别调用：
const cartA = useCartA()
const cartB = useCartB()
cartA.items.push({ id: 1 }) // 只影响 cart-a
cartB.items.push({ id: 2 }) // 只影响 cart-b如何真正实现“多个 Pinia 实例”？（极少需要）
虽然非常规，但 Pinia 支持创建多个实例（例如用于微前端、测试隔离、多租户场景）：
- 每个
createPinia()调用生成一个独立实例； - 每个实例需单独挂载到对应 Vue 应用（或子应用）；
- Store 必须显式注册到对应实例（通过
pinia.use()或store(pinia)）。
// 实例 1：主应用
const piniaMain = createPinia()
app.use(piniaMain)
// 实例 2：嵌入的子模块（如 iframe 或微前端子应用）
const piniaSub = createPinia()
subApp.use(piniaSub)
// 注意：useUserStore 默认注册到默认 Pinia 实例
// 若需绑定到特定实例，需手动传入
export const useUserStore = defineStore('user', { /* ... */ })
useUserStore(piniaSub) // 显式绑定到 piniaSub⚠️ 注意：这种方式会失去自动注入能力（如 useUserStore() 在 setup 中直接调用将失败），必须显式传参或使用 pinia.use() 注册插件。
Store 间通信：隔离 ≠ 孤立
作用域隔离不等于不能协作。Store 之间可通过以下方式安全交互：
-
直接导入调用：在某个 Store 的
actions或getters中，调用另一个 Store 实例的方法或读取其状态； - 依赖注入式解耦：把被依赖的 Store 作为参数传入（适合测试或高阶抽象）；
- 事件总线 / 自定义事件：避免强耦合，适用于松散关联场景（如通知、日志上报）。
// stores/order.ts
import { useCartStore } from './cart'
export const useOrderStore = defineStore('order', {
actions: {
checkout() {
const cart = useCartStore() // 获取 cart 实例
if (cart.items.length === 0) return
// 提交订单逻辑...
cart.clear() // 调用 cart 的 action
}
}
})小结：Pinia 的“作用域隔离”本质是设计约定
- ✅ 多 Store = 多个
defineStore函数 + 唯一 ID → 天然隔离、可复用、易测试； - ✅ 不需要手动 new 或 clone，每个
useXxxStore()调用都返回新响应式代理（但底层共享同一份定义逻辑）； - ❌ 不要试图用多个 Pinia 实例来“模拟模块隔离”——这违背 Pinia 的设计初衷，也增加维护成本；
- ? Store 间协作应明确、可控、可追溯，避免隐式依赖或循环调用。
