一、Pinia是什么？

Pinia 是 Vue 的专属状态管理库，它允许支持跨组件或页面共享状态，即共享数据，他的初始设计目的是设计一个支持组合式API的 Vue 状态管理库（因为vue3一个很大的改变就是组合式API）,当然这并不是说Pinia只支持vue3，他是同时支持vue2和vue3的，本文倾向于拥抱Vue3，所以代码语法都是倾向用组合式api的写法

二、在vue3中使用Pinia

下面的流程和相关代码均基于vue3项目

1、安装pinia

npm install pinia

或用yarn安装

yarn add pinia

package.json中看到pinia表示安装成功 

2、创建pinia实例并将其传递给应用

//src/main.js

//创建应用实例
import { createApp } from "vue";
import App from "./App.vue";
let app = createApp(App);

//pinia实例
import { createPinia } from "pinia";
let pinia = createPinia();
app.use(pinia);

app.mount("#app");

挂载完成后，我们就可以在Vue的devtools里看到Pinia了

3、定义Store

Store 是用 defineStore() 定义的，它的第一个参数要求是一个独一无二的名字,在整个应用中保持唯一， 返回的函数命名为 use... 是一个符合组合式函数风格的约定

import { defineStore } from "pinia";

//命名规则，建议以 `use` 开头且以 `Store` 结尾，即 use~~~Store
export const useMapStore = () => {

    // 其他配置...
}

Setup store(Option Store可以查看官方，本文不列举)

import { defineStore } from "pinia";
import { reactive, computed } from "vue";
import type { City, Province } from "@/interface/common";

export const useMapStore = defineStore("mapStore", () => {
  //state
  let cityList = reactive<Array<City>>([]);
  let provinceList = reactive([]);

  //getter
  const simpleCityList = computed(() => {
    return cityList.filter((item) => item.code != "110000");
  });

  //actions
  function changeCityList(list: City[]) {
    console.log("修改城市列表数据的事件被触发");
    cityList = Object.assign(cityList, list);
  }
  function changeProviceList(list: Province[]) {
    console.log("修改省份列表数据的事件被触发");
    provinceList = Object.assign(provinceList, list);
  }

  return {
    cityList,
    provinceList,
    simpleCityList,
    changeCityList,
    changeProviceList,
  };
});

 

4、使用store

<template>
    <div>您好！欢迎来到星野的小世界</div>
    <div>星野的目标是走遍中国的每一个省，中国的省如下：</div>
    <div>
        <ul>
            <li v-for="city in cityList" :key="city.code">
                {{ city.name }}
            </li>
        </ul>
    </div>
</template>

<script setup lang='ts' name='Login'>
import { onMounted} from 'vue';
import { storeToRefs } from 'pinia';
import { getCityList } from "@/utils/common";
import { useMapStore } from '@/stores/map'

let mapStore = useMapStore()
let { cityList } = storeToRefs(mapStore) //为了从 store 中提取属性时保持其响应性，需要使用 storeToRefs()。它将为每一个响应式属性创建引用

onMounted(async () => {
    let list = await getCityList()
    mapStore.changeCityList(list) //修改store里的属性数据
})
</script>
<style lang='scss' scoped></style>

getCityList是一个工具函数，调用一个免费api获取中国的城市数据 

在 Setup Store 中：

• ref() /reactive ( ) 就是 state 属性
• computed() 就是 getters
• function() 就是 actions

页面效果

5、修改store中的state

例如store中的state有一个城市统计属性： cityCount

在业务组件里，就可以通过mapStore.cityCount 直接修改数量

 

如果state有很多属性，还可以调用 $patch 方法。它允许你用一个 state 的补丁对象在同一时间更改多个属性

 mapStore.$patch({
        cityCount: mapStore.cityCount + 1,
        provinceCount: mapStore.provinceCount + 1
    })

好啦，Pinia 满足基础使用的读写改操作已经描述完毕，关于搭配 Nuxt 的 Pinia 完成SSR，后续会单独出文，敬请期待！😁

ps： 学习成长过程的简单记录，如有不恰当之处，欢迎交流