本文承接上一篇Vue3 中使用 Vuex 和 Pinia 对比之 Vuex的用法
与Vuex 相比，如果你觉得 Vuex 比较麻烦的话，那么Pinia提供了更简单的 API，具有更少的操作，简单理解一下，就是相当于把 Vuex 的 mutation 和 action 融成了一个，也就是说，比无需像 Vuex 要考虑异步任务，Pinia 让你直接异步请求操作修改数据状态。
Pinia（发音为 /pi?nj?/，类似于英语中的“peenya”）是最接近有效包名 pi?a（西班牙语中的_pineapple_）的词。 菠萝实际上是一组单独的花朵，它们结合在一起形成多个水果。
Pinia 最初是为了探索 Vuex 的下一次迭代会是什么样子，结合了 Vuex 5 核心团队讨论中的许多想法。最终Pinia 团队意识到 Pinia 已经实现了在 Vuex 5 中想要的大部分内容，并决定实现它 取而代之的是新的建议。
与 Vuex 相比，Pinia 提供了一个更简单的 API，具有更少的规范，提供了 Composition-API 风格的 API，最重要的是，在与 TypeScript 一起使用时具有可靠的类型推断支持。
yarn add pinia
# 或者使用 npm
npm install pinia
import { defineStore } from 'pinia'
// useStore 可以是 useUser、useCart 之类的任何东西
// 第一个参数是应用程序中 store 的唯一 id
export const useStore = defineStore('test1', {
// other options...
})
上面的 ‘test1’ ，这个 name，也称为 id，是必要的，Pinia 使用它来将 store 连接到 devtools。 将返回的函数命名为 use… 是跨可组合项的约定，以使其符合你的使用习惯。
上面我们仅仅是定义了一个 store，在 setup() 中调用 useStore() 之前不会创建 store：
import { useStore } from '@/stores/counter'
export default {
setup() {
const store = useStore()
return {
// 您可以返回整个 store 实例以在模板中使用它
store,
}
},
}
一旦 store 被实例化，你就可以直接在 store 上访问 state、getters 和 actions 中定义的任何属性。
注意事项：store 是一个用reactive 包裹的对象，这意味着不需要在getter 之后写.value，但是，就像setup 中的props 一样，我们不能对其进行解构：
export default defineComponent({
setup() {
const store = useStore()
// ? 这不起作用，因为它会破坏响应式
// 这和从 props 解构是一样的
const { name, doubleCount } = store
name // "eduardo"
doubleCount // 2
return {
// 一直会是 "eduardo"
name,
// 一直会是 2
doubleCount,
// 这将是响应式的
doubleValue: computed(() => store.doubleCount),
}
},
})
为了从 Store 中提取属性同时保持其响应式，需要使用storeToRefs()。 它将为任何响应式属性创建 refs。 当仅使用 store 中的状态但不调用任何操作时，可以这样使用：
import { storeToRefs } from 'pinia'
export default defineComponent({
setup() {
const store = useStore()
// `name` 和 `doubleCount` 是响应式引用
// 这也会为插件添加的属性创建引用
// 但跳过任何 action 或 非响应式（不是 ref/reactive）的属性
const { name, doubleCount } = storeToRefs(store)
return {
name,
doubleCount
}
},
})
默认情况下，可以通过 store 实例访问状态来直接读取和写入状态：
const store = useStore()
store.counter++
可以通过调用 store 上的 $reset() 方法将状态 重置 到其初始值：
const store = useStore()
store.$reset()
getter 同 Vuex 一样，它也等效于 Vue 的 computed ，计算属性，和 state 一样直接调用即可
export const useStore = defineStore('main', {
state: () => ({
counter: 0,
}),
getters: {
doubleCount: (state) => state.counter * 2,
},
})
//在页面中使用
const store = useStore();
console.log(store.doubleCount);
getter 中是可以互相嵌套访问的，比如 getters 中有 getA 和 getB
getters:{
getA:(state)=>state.counter *2,
getB(){//需要使用 getA ，那么这个函数就不要用 箭头函数了，普通函数，通过 this 直接拿到 getA
return this.getA +1;
}
}
Getters 只是幕后的 computed 属性，因此无法向它们传递任何参数。 但是，您可以从 getter 返回一个函数以接受任何参数：
//定义 store
export const useStore = defineStore('main', {
getters: {
getUserById: (state) => {
return (userId) => state.users.find((user) => user.id === userId)// 返回一个函数用以接收参数；
},
},
})
//------在组件中使用------
<script>
export default {
setup() {
const store = useStore()
return { getUserById: store.getUserById }
},
}
</script>
<template>
<p>User 2: {{ getUserById(2) }}</p>
</template>
Actions 相当于组件中的 methods。 它们可以使用 defineStore() 中的 actions 属性定义，并且它们非常适合定义业务逻辑：
export const useStore = defineStore('main', {
state: () => ({
counter: 0,
}),
actions: {
increment() {
this.counter++
},
randomizeCounter() {
this.counter = Math.round(100 * Math.random())
},
},
})
//在组件中使用时，Actions 像 methods 一样被调用：
export default defineComponent({
setup() {
const main = useMainStore()
// Actions 像 methods 一样被调用：
main.randomizeCounter()
return {}
},
})
与 getters 一样，操作可以通过 this 访问 whole store instance 并提供完整类型（和自动完成）支持。 与它们不同，actions 可以是异步的，可以在其中await 任何 API 调用甚至其他操作！
import { mande } from 'mande'
const api = mande('/api/users')
export const useUsers = defineStore('users', {
state: () => ({
userData: null,
// ...
}),
actions: {
async registerUser(login, password) {
try {
this.userData = await api.post({ login, password })
showTooltip(`Welcome back ${this.userData.name}!`)
} catch (error) {
showTooltip(error)
// 让表单组件显示错误
return error
}
},
},
})
个人觉得，你喜欢哪个用哪个，但是有如下对比，供大家自行参考：
| 名称 | 优点 | 缺点 | 适用（推荐）场景 |
|---|---|---|---|
| Vuex | 1. 更加成熟； 2. 也是因为第一点，所以它也更加稳定； 3. 更强大：提供了一些高级功能，比如：中间件和插件，使得它可以处理更加复杂的状态管理需求； | 1. 学习成本高，相对于Pinia 难一些； 2. 相对来说比较繁琐，概念比较复杂； 3. 量级比较大，包体积也大 ； | 1. 大型SPA项目； 2. 高复杂度且对 store 要求有更多功能和灵活性的开发者 |
| Pinia | 1. 轻量级，体积小 约 1KB； 2. 简单易用； 3. 更灵活，提供了多store ; 4. 允许捆绑器自动对它们进行代码拆分，并提供更好的 TypeScript 推理。 | 1. 相对来说有点新； 2. 生态不够完善，没有Vuex 那么庞大的社区支持和解决方案； | 1. 中小型应用，需要简单轻量级的状态管理库的开发者； 2. 低复杂度的Vue 项目； 3. 更流畅的开发体验； |