一、安装与初始化
安装pinia
npm install pinia # 或 yarn add pinia
目的:引入pinia核心库,为状态管理提供基础支持。
挂载pinia实例
在main.js中初始化并注入vue应用:
import { createapp } from 'vue'
import { createpinia } from 'pinia'
import app from './app.vue'
const app = createapp(app)
const pinia = createpinia()
app.use(pinia) // 关键!全局启用pinia
app.mount('#app')作用:创建pinia实例并与vue3应用集成,使所有组件可访问store。
二、创建store(函数式写法)
使用composition api风格定义store(推荐):
// stores/counter.js
import { definestore } from 'pinia'
import { ref, computed } from 'vue'
export const usecounterstore = definestore('counter', () => {
// 1. 定义状态(相当于data)
const count = ref(0)
// 2. 定义计算属性(相当于getters)
const doublecount = computed(() => count.value * 2)
// 3. 定义操作方法(相当于actions)
function increment() {
count.value++
}
// 暴露状态与方法
return { count, doublecount, increment }
})核心要点:
definestore第一个参数为store唯一id(需全局唯一)- 使用
ref/computed等响应式api管理状态 - 通过函数返回值暴露需共享的状态与方法
- 注意这个的id和实际没什么关系,你最后还是使用usecounterstore 来获取对象
三、在组件中使用store
引入store实例
在组件<script setup>中调用store:
<script setup>
import { usecounterstore } from '@/stores/counter'
const counterstore = usecounterstore() // 实例化store
</script>特性:store按需实例化,支持多组件复用且状态自动同步。
模板中访问状态与方法
<template>
<div>
<p>当前计数:{{ counterstore.count }}</p>
<p>双倍计数:{{ counterstore.doublecount }}</p>
<button @click="counterstore.increment()">+1</button>
</div>
</template>响应式原理:直接访问store的属性会触发vue的响应式更新。
四、高级功能扩展
状态持久化(示例)
安装插件并配置:
npm install pinia-plugin-persistedstate
// main.js import piniapluginpersistedstate from 'pinia-plugin-persistedstate' pinia.use(piniapluginpersistedstate)
在store中启用:
definestore('counter', () => { /* ... */ }, {
persist: {
enabled: true, // 开启持久化
storage: sessionstorage, // 可选存储方式(默认localstorage)
paths: ['count'] // 指定需持久化的字段
}
})作用:浏览器刷新后自动恢复指定状态。
模块化开发
- 创建多个store文件(如
userstore.js、cartstore.js) - 组件按需引入不同store,实现逻辑解耦
五、调试技巧
vue devtools集成
安装浏览器插件后,可查看store状态变化历史与时间旅行调试。
自定义插件
可开发日志插件跟踪状态变更(示例见网页4的日志监控代码)。
总结
通过以上步骤可实现:
- ✅ 响应式状态管理:基于composition api的store声明
- ✅ 跨组件共享:多组件间高效同步复杂状态
- ✅ 可维护性:模块化store设计与类型安全(天然支持ts)
- ✅ 扩展性:通过插件实现持久化、日志等高级功能
对比vuex,pinia的函数式store语法更简洁,且与vue3的composition api深度契合,推荐作为vue3项目的首选状态管理方案。
以上为个人经验,希望能给大家一个参考,也希望大家多多支持代码网。
发表评论