怎么说呢,其实在过往的大部分项目里面,我并没有引入过状态管理相关的库来维护状态。因为大部分的业务项目相对来说比较独立,哪怕自身功能复杂的时候,可能也仅仅是通过技术栈自身的提供的状态管理能力来处理业务场景问题,比如React中的context,基本都能解决我遇到的问题。
针对Redux或者Vuex这类状态管理的库,我认为在较为复杂的大型业务场景下才能发挥他们的真实作用,在场景较为简单单一,数据状态相对不复杂的时候,引入他们可能并不能带来那么多的便捷。
说回Pinia,接触使用到它主要是因为有一次手里的发布功能需要进行重构。虽然仅仅是一个发布页面,但是梳理起来发现,里面涉及几类数据需要维护,包括主表单信息、错误校验信息、公共弹窗信息以及关联用户的各种状态信息等。想起之前有看到过关于小🍍的介绍,抱着试试看的心态接入试试。(不行我就继续Provide/Inject了[捂脸])
Pinia 是 Vue 的存储库,它允许您跨组件/页面共享状态。
上面这个是官网对Pinia的一个定义,从定义上我们其实可以看出来,它可能比Vuex要精炼一些(Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式 + 库。它采用集中式存储管理应用的所有组件的状态,并以相应的规则保证状态以一种可预测的方式发生变化。)具体如何我们还是得具体从使用情况来看一下。
安装
通过常用的包管理器进行安装:
yarn add pinia
// 或者
npm install pinia
安装完成后,我们需要将pinia挂载到Vue应用中,也就是我们需要创建一个根存储传递给应用程式。我们需要修改main.js,引入pinia提供的cteatePinia方法:
import { createApp } from 'vue';
import { createPinia } from 'pinia';const pinia = createPinia();
const app = createApp(App);
app.use(pinia).mount('#app');
上述安装引入基于Vue3,如果使用Vue2的话,轻参照官网相关说明即可。
Store
store简单来说就是数据仓库的意思,我们 的数据都放在store里面。当然你也可以把它理解为一个公共组件,只不过该公共组件只存放数据,这些数据我们其它所有的组件都能够访问且可以修改。它有三个概念,state、getters和actions,我们可以将它们等价于组件中的“数据”、“计算属性”和“方法”。
store中应该包含可以在整个应用中访问的数据、全局性数据,我们应该避免将可以管理在具体组件内部的数据放到store中。
我们需要使用pinia提供的defineStore()方法来创建一个store,该store用来存放我们需要全局使用的数据。我们可以在项目中创建store目录存储我们定义的各种store:
// src/store/formInfo.js
import { defineStore } from 'pinia';// 第一个参数是应用程序中 store 的唯一 id
const useFormInfoStore = defineStore('formInfo', {// 其他配置项,后面逐一说明
})export default useFormInfoStore;
defineStore接收两个参数:
将返回的函数命名为 use... 是组合式开发的约定,使其符合使用习惯。我们可以根据项目情况定义任意数量的store存储不同功能模块的数据,一个store就是一个函数,它和Vue3的实现思想也是一致的。
使用store
我们可以在任意组件中引入定义的store来进行使用
store 被实例化后,你就可以直接在 store 上访问 state、getters 和 actions 中定义的任何属性。
解构store
store 是一个用reactive 包裹的对象,这意味着不需要在getter 之后写.value,但是,就像setup 中的props 一样,我们不能对其进行解构,如果我们想要提取store中的属性同时保持其响应式的话,我们需要使用storeToRefs(),它将为响应式属性创建refs。
State
store是用来存储全局状态数据的仓库,那自然而然需要有地方能够保存这些数据,它们就保存在state里面。defineStore传入的第二个参数options配置项里面,就包括state属性。
// src/store/formInfo.js
import { defineStore } from 'pinia';
const useFormInfoStore = defineStore('formInfo', {// 推荐使用 完整类型推断的箭头函数state: () => {return {// 所有这些属性都将自动推断其类型name: 'Hello World',age: 18,isStudent: false}}// 还有一种定义state的方式,不太常见,了解即可// state: () => ({// name: 'Hello World',// age: 18,// isStudent: false// })
})
export default useFormInfoStore;
访问state
默认情况下,您可以通过 store 实例来直接读取和写入状态:
pinia还提供了几个常见场景的方法供我们使用来操作state:$reset、$patch、$state、$subscribe:
针对上面示例,有几点需要关注一下:


如上图,针对gender属性,执行的是"add"操作,然后这个替换过程我们没有设置isStudent属性,它仍然保持原状态在state中不变。
Getters
pinia中的getters可以完全等同于Store状态的计算属性,通常在defineStore中的getters属性中定义。同时支持组合多个getter,此时通过this访问其他getter。
import { defineStore } from 'pinia';
const useFormInfoStore = defineStore('formInfo', {state: () => {return {name: 'Hello World',age: 18,isStudent: false,gender: '男'};},getters: {// 仅依赖state,通过箭头函数方式isMan: (state) => {return state.gender === '男';},isWoman() {// 通过this访问其他getter,此时不可以用箭头函数return !this.isMan;}}
});
export default useFormInfoStore;
在使用时,我们可以直接在store实例上面访问getter:
The person is Man: {{ formInfoStore.isMan }} or is Woman: {{ formInfoStore.isWoman }}
通常getter是不支持额外传参的,但是我们可以从getter返回一个函数的方式来接收参数:
import { defineStore } from 'pinia';
const useFormInfoStore = defineStore('formInfo', {state: () => {return {name: 'Hello World',age: 18,isStudent: false,gender: '男'};},getters: {isLargeBySpecialAge: (state) => {return (age) => {return state.age > age}}}
});
export default useFormInfoStore;
在组件中使用时即可传入对应参数,注意,在这种方式时,getter不再具有缓存性。
The person is larger than 18 years old? {{ formInfoStore.isLargeBySpecialAge(18) }}
Actions
actions相当于组件中的methods,它们定义在defineStore中的actions属性内,常用于定义业务逻辑使用。action可以是异步的,可以在其中await 任何 API 调用甚至其他操作
import { defineStore } from 'pinia';
const useFormInfoStore = defineStore('formInfo', {state: () => {return {name: 'Hello World',age: 18,isStudent: false,gender: '男'};},getters: {isMan: (state) => {return state.gender === '男';},isWoman() {return !this.isMan;}},actions: {incrementAge() {this.age++;},async registerUser() {try {const res = await api.post({name: this.name,age: this.age,isStudent: this.isStudent,gender: this.gender});showTips('用户注册成功~');} catch (e) {showError('用户注册失败!');}}}
});
export default useFormInfoStore;
使用起来也非常方便
$onAction()
可以使用 store.$onAction() 订阅 action 及其结果。传递给它的回调在 action 之前执行。 after 处理 Promise 并允许您在 action 完成后执行函数,onError 允许您在处理中抛出错误。
const unsubscribe = formInfoStore.$onAction(({name, // action 的名字store, // store 实例args, // 调用这个 action 的参数after, // 在这个 action 执行完毕之后,执行这个函数onError, // 在这个 action 抛出异常的时候,执行这个函数}) => {// 记录开始的时间变量const startTime = Date.now()// 这将在 `store` 上的操作执行之前触发console.log(`Start "${name}" with params [${args.join(', ')}].`)
// 如果 action 成功并且完全运行后,after 将触发。// 它将等待任何返回的 promiseafter((result) => {console.log(`Finished "${name}" after ${Date.now() - startTime}ms.\nResult: ${result}.`)})
// 如果 action 抛出或返回 Promise.reject ,onError 将触发onError((error) => {console.warn(`Failed "${name}" after ${Date.now() - startTime}ms.\nError: ${error}.`)})}
)
// 手动移除订阅
unsubscribe()
和$subscribe类似,在组件中使用时,组件卸载,订阅也会被删除,如果希望保留的话,需要传入true作为第二个参数。
Pinia的基础使用我们暂时介绍到这里,其他使用场景大家可以参照官方文档进一步学习。
回过头来,我们再来看一下,Pinia为什么现在这么受到推崇。和我们过往常用的Vuex相比,它到底好在哪里呢?
对于Vuex,我们知道,它的背后基本思想借鉴了Flux。Flux 是 Facebook 在构建大型 Web 应用程序时为了解决数据一致性问题而设计出的一种架构,它是一种描述状态管理的设计模式。绝大多数前端领域的状态管理工具都遵循这种架构,或者以它为参考原型。Vuex在它的基础上进行了一些设计上的优化:

Vuex主要有五部分核心内容:
🛠 mutation:类似于事件,包含一个类型名和对应的回调函数,在回调函数中可以对 state 中的数据进行同步修改。
store.commit 方法提交一个操作,并将参数传入回调函数。type 和负载 payload。🔨 action:action 内部的操作不受限制,可以进行任意的异步操作。我们需要通过 dispatch 方法来触发 action 操作,同样的,参数包含了类型名 type 和负载 payload。
commit 来提交 mutation 也能达到一样的效果。📁 module:store 的分割,每个 module 都具有独立的 state、getter、mutation 和 action。
module.registerModule 动态注册模块。通过和我们上面学习到的Pinia的基础内容对比可以看出,Pinia舍弃了mutation和module两部分,这样我们在使用时就更加的便捷。

与Vuex3.x/4.x对比,主要区别如下:
其实对于我来说,之所以选择Pinia,甚至是喜欢上它,是因为它和Vue3的组合是API形式更加贴合,只需要把它当作一个特殊的数据状态组件来使用就好,不需要那么复杂的流程。
通过对Pinia的基本功能的使用介绍,以及和Vuex进行对比,让我们比较清晰的来认识Pinia,使我们能够入门使用。在具体业务场景中,有效的划分Store,合理的组合使用,可以帮助我们完成复杂的业务逻辑。
参考内容:
pinia中文文档
Pinia or Vuex?
Vuex 与 Pinia 的设计实现对比
上一篇:随机数森林
下一篇:DJ1-3 操作系统引论