导航：首页 > 开发技术 >

Vue生态的新成员Pinia怎么用

发表于：2026-10-31 作者：千家信息网编辑

千家信息网最后更新 2026年10月31日，小编给大家分享一下Vue生态的新成员Pinia怎么用，相信大部分人都还不怎么了解，因此分享这篇文章给大家参考一下，希望大家阅读完这篇文章后大有收获，下面让我们一起去了解一下吧！Pinia是Vue应用程

千家信息网最后更新 2026年10月31日Vue生态的新成员Pinia怎么用

小编给大家分享一下Vue生态的新成员Pinia怎么用，相信大部分人都还不怎么了解，因此分享这篇文章给大家参考一下，希望大家阅读完这篇文章后大有收获，下面让我们一起去了解一下吧！

Pinia是Vue应用程序的状态管理方案，是Vuex核心团队成员开发。感觉更像是常规的旧 javascript 导入模块，实现了很多Vuex5的提案。

Pinia同时支持Vue2和Vue3，不过下面展示的例子都是使用Vue3，Pinia的版本是Pinia@2.0.9。

Vue2和Vue3使用的Pinia版本有一点不同，因此请查看官方 Pinia 文档以获取更多信息。

安装和配置

可以使用npm或者yarn安装Pinia

yarn add pinia@next# 或者 使用npmnpm install pinia@next

安装完毕后，找到Vue应用程序的文件 main.js (vue-cli初始化的项目，一般都命名为main.js)。从Pinia的npm包中导入createPinia，然后使用Vue的use方法作为插件使用

//main.jsimport { createApp } from 'vue'import App from './App.vue'import router from './router'import { createPinia } from 'pinia'createApp(App)  .use(router)  .use(createPinia())  .mount('#app')

接下来，我们去创建一个 store

Store核心

Pinia的Store不同于Vuex的Store。使用Vuex的时候，整个应用程序只有一个主要Store（虽然你可以拆成不同的模块，但是还是一个主存储出口）。然而，今天的主角Pinia则是开箱即用的模块化设计，不在需要一个主要的Store，可以创建不同的Store。例如，我们可以创建一个登录用户Store。

// store/loggedInUser.jsimport { defineStore } from 'pinia'export const useLoggedInUserStore = defineStore({// id 是必填的，并且所有 Store 中唯一。因为Pinia会将它在devtools显示  id: 'loggedInUser',  state () {    return {      name: '太凉',      age: 18,      email: 'fake@email.com'    }  },  getters: {},  actions: {}})

上面我们创建了一个登录用户Store，接下来我们可以直接在组件中引用,然后在setup函数中调用useLoggedInUserStore

这与 Vuex 有很大不同，Vuex 的Store 会自动挂载到当前Vue的实例，可以通过this.$store的方式调用。然而，Pania 方式也让开发人员更清楚Store来自哪里，因为它是标准的 Javascript 模块导入，可以看到是从哪个文件导入的。

假如，你不用 Composition API的方式，你仍然可以借助一些辅助函数使用Pinia，下面将会详细说，这里先提一嘴。

State

我们将 Store 中的 state 属性设置为一个函数，该函数返回一个包含不同状态值的对象。这与我们在组件中定义data的方式非常相似。事实上，唯一的区别是属性名称：状态与数据

import { defineStore } from 'pinia'export const useLoggedInUserStore = defineStore({// id 是必填的，并且所有 Store 中唯一。因为Pinia会将它在devtools显示  id: 'loggedInUser',  state () {    return {      name: '太凉',      age: 18,      email: 'fake@email.com'    }  },  getters: {},  actions: {}})

现在，为了从组件中访问 loginUserStore 的状态，我们只需要引用我们需要的Store，这种方式非常优雅。完全不需要像Vuex那样从嵌套对象中找到我们需要的Store。

警告,不能结构user，因为那样会失去响应式。下面的方式是错误的。

❌ const {name, email} = useLoggedInUserStore()

如果你使用的不是Composition API的方式，而是Option API的方式。可以通过Pinia的mapState函数获取 State数据。Pinia的mapState函数和Vuex的mapState虽然名字相同，但是使用方式完全不同。

Pinia的mapState函数的第一个参数是必须是之前创建的Store，第二个参数是Store中的state的属性值。看代码

//PageComponent.vue

总结：

定义Pinia的state，和组件的data的方式是一样
需要在组件间中手动导入我们需要的Store模块，这样做的好处是明确知道数据的来源，更符合标准的 Javascript

Getters

Pinia中的getters和Vuex中的getters 的作用是相同的，都是作为组件的计算属性(computed)。
创建getters的方式有两种，一种是通过this关键字，一种是通过state具体看代码

//store/usePostsStore.jsimport { defineStore } from 'pinia'export const usePostsStore = defineStore({  id: 'PostsStore',  state: ()=>({ posts: ['post 1', 'post 2', 'post 3', 'post 4'] }),  getters:{    // 传统函数方式    postsCount: function(){      return this.posts.length    },    // 传统函数简写方式    postsCount2(){      return this.posts.length    },    // 箭头函数    postsCount3:(state)=>state.posts.length,    // ❌ 不能用箭头函数+this的方式，这种方式this指向不对    // postsCount: ()=> this.posts.length  }})

接下来看Composition API方式的组件中如何使用创建的getters，其实用法和state相同。看代码

如果是Option API 的组件，不能像Vuex那样通过mapGetters辅助函数获取。因为Pinia没有mapGetters辅助函数，Pinia中消费getters还是借助 mapState辅助函数

Actions

Pinia不同于Vuex，Pinia提供了单一的方式更改state的值，在Pinia中没有mutations,只有action方式。先来看一下Pinia的action怎么用吧。上代码

直接通过this找到对应的state修改
通过.$patch 函数方法
通过.$patch 对象方法

import { defineStore } from 'pinia'export const usePostsStore = defineStore({  id: 'PostsStore',  state: () => ({    posts: ['post 1', 'post 2', 'post 3', 'post 4'],    user: { postsCount: 2 },    age:18,    errors: []  }),  getters: {    postsCount: function () {      return this.posts.length    },    postsCount2 () {      return this.posts.length    },    // 箭头函数    postsCount3: (state) => state.posts.length  },  actions: {    insertPost () {      //方式1：直接通过this找到对应的state修改      this.posts.push(`post_${Date.now()}`)      this.user.postsCount++    },    removePost () {      //方式2：通过.$patch 函数方法      this.$patch((state) => {        state.posts.shift()        state.user.postsCount++      })            //通过.$patch 对象方法      this.$patch({        age:30      });    }  }})

以上展示了三种更改Pinia的State方式。

如果是 Composition API使用方式

如果是 Options API使用方式，需要借助辅助函数 mapActions

// PostEditorComponent.vue

其实Pinia的action使用非常灵活

可以在组件或者其他actions里面调用
可以在其他的Store的actions里面调用

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

支持同步和异步
可以支持灵活的参数
...............

Vue Devtools

在 Vue 2 中，Pania 支持在 Vuex 选项卡中查看状态，甚至可以看到时间轨迹。时间轨迹的标签几乎没有在 Vuex 中使用时那么好。
至于 Vue 3，Pania 仅支持在 devtools 中查看状态，不支持时间轨迹功能。然而，这实际上比 Vuex 为 Vue 3 提供的要多，因为它在最新的开发工具中根本不支持。