Pinia
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/antfu-skills-pinia。
技能介绍
什么问题
在 Vue 应用里,组件树变深、路由和异步请求变多之后,跨页面共享状态、在导航守卫里读用户信息、以及在 SSR 时避免服务端与客户端状态不一致,单靠 provide/inject 或事件总线往往难以维护类型,也容易踩循环依赖。
技能覆盖什么
本技能以 Pinia v3.0.4 为基准,把官方能力拆成可检索的主题块,便于在写代码时对齐做法:
- 核心 Store:定义 store、
state/getters/actions、storeToRefs、订阅 - 扩展与组合:插件自定义状态与行为;在 store 内使用 VueUse 等 composable;多 store 协作与避免循环依赖
- 工程化:
@pinia/testing做单测与 mock;在路由守卫、插件、中间件等组件外使用 store - 进阶:SSR 注水与状态同步、Nuxt 自动导入与 SSR 约定、开发期 HMR
技能中还强调几条容易写错的点:复杂逻辑优先 Setup Store;解构状态/ getter 用 storeToRefs();actions 可直接解构;SSR 场景不要在模块顶层调用 store;可为每个 store 配置 HMR。
适用边界
技能是开发参考与约定归纳,不包含替你搭完整项目脚手架,也不替代 Pinia 官方文档的版本差异说明。若你仍在 Vuex 迁移期,需自行对照项目版本与 Nuxt 集成方式。
使用场景
- 在 Vue 3 路由守卫里读取登录态,需要知道组件外如何安全调用 Pinia store
- Setup Store 里接入 VueUse 的 composable,并避免与其它 store 形成循环依赖
- 为 Nuxt 页面做 SSR,需要把服务端取到的数据正确注水到 Pinia 再渲染
- 给依赖 store 的组件写单测,需要用 @pinia/testing 做 mock 与 stub
适合人员
- 维护中大型 Vue 3 前端、需要把分散的接口数据收敛到可测试 store 的工程师
- 使用 Nuxt 做同构渲染、要在服务端与客户端共享同一份 Pinia 状态的开发者
- 从 Vuex 迁到 Pinia、需要对照 getters/actions 与 Setup Store 写法的维护者
- 负责前端质量、要给带全局状态的组件补齐单测与 mock 策略的测试编写者