Pinia 快速上手要点

使用 defineStore 创建一个 store, 每个 store 要设置一个唯一 id；

 import { defineStore } from 'pinia' import { ref } from 'vue'  // useStore 可以是 useUser、useCart 之类的任何东西 // 第一个参数是应用程序中 store 的唯一 id export const useMainStore = defineStore('main', {   // other options...     const name = ref('cherish') 	const count = ref(0)          return {     	name,         count 	} })  

改变state 的值时不需要借助 mutation (pinia中没有mutation), 默认情况下，您可以通过 store 实例访问状态来直接读取和写入状态；

 const mainStore = useMainStore() mainStore.count++  

除了直接用 store.count++ 修改 store，你还可以调用 $patch 方法同时应用多个更改; $patch 方法也接受一个函数来批量修改集合内部分对象的情况;

 const mainStore = useMainStore() mainStore.$patch({   counter: mainStore.counter + 1,   name: 'yb.z', })  

useMainStore 中的返回值，不能使用解构语法，否则会失去响应性，但是可以使用 storeToRefs 包裹 store，然后可以使用解构；

 import { storeToRefs } from 'pinia'  const mainStore = useMainStore() // 正确 const { name } = useMainStore() // 错误 const { name } = storeToRefs(useMainStore()) // 正确  

通过调用 store 上的 $reset() 方法将状态 重置 到其初始值；

 const mainStore = useMainStore() mainStore.name = 'yb.z' mainStore.$reset() // mainStore.name cherish  

可以通过将其 $state 属性设置为新对象来替换 Store 的整个状态;

 const mainStore = useMainStore() mainStore.$state = { counter: 666, name: 'yb.z' }  

可以通过 store 的 $subscribe() 方法查看状态及其变化, 与常规的 watch() 相比，使用 $subscribe() 的优点是 subscriptions 只会在 patches 之后触发一次;

使用getter 和 直接在状态中使用 computed 计算的效果一样；

如果一个 getter 依赖另一个 getter，通过 this 访问任何其他 getter；

 export const useStore = defineStore('main', {   state: () => ({     counter: 0,   }),   getters: {     // 类型是自动推断的，因为我们没有使用 `this`     doubleCount: (state) => state.counter * 2,     // 这里需要我们自己添加类型（在 JS 中使用 JSDoc）。 我们还可以     // 使用它来记录 getter     /**      * 返回计数器值乘以二加一。      *      * @returns {number}      */     doubleCountPlusOne() {       // 自动完成 ✨       return this.doubleCount + 1     },   }, })  

同 computed 属性一样，getter 默认是不能传递参数进去的，但是，您可以从 getter 返回一个函数以接受任何参数，此时 getter 变成了一个普通函数，不再缓存数据。

要使用其他 store 的 getter, 可以直接在一个 store 中引入和使用另一个 store;

import { useOtherStore } from './other-store'  export const useStore = defineStore('main', {   state: () => ({     // ...   }),   getters: {     otherGetter(state) {       const otherStore = useOtherStore()       return state.localData + otherStore.data     },   }, }) 

getter 的访问和 state 一模一样，都是 xxxStore.xxx;

与 getter 一样，actions 操作可以通过 this 访问整个 store 实例，不同的是，action 可以是异步的，当然也可以是同步的，你可以在它们里面 await 调用任何 API，以及其他 action！可以把 action 理解为普通的方法；

想要使用另一个 store 的action的话，可以直接在一个 store 中引入和使用另一个 store， 然后直接在 action 中调用就好了另一个 store 的action 就好了。

import { useAuthStore } from './auth-store'  export const useSettingsStore = defineStore('settings', {   state: () => ({     preferences: null,     // ...   }),   actions: {     async fetchUserPreferences() {       const auth = useAuthStore()       if (auth.isAuthenticated) {         this.preferences = await fetchPreferences()       } else {         throw new Error('User must be authenticated')       }     },   }, })