Agent Skills
返回列表
💻

Pinia

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/uni-helper-skills-pinia。

技能介绍

要解决什么问题

在 Vue 3 项目里,跨组件共享状态、在路由守卫或中间件里读写业务数据,很容易写成 props 层层下发或模块级单例,响应式会断、SSR 也容易把服务端和客户端状态搅在一起。Pinia 是 Vue 官方推荐的状态管理库,既要会用 defineStore、getters 与 actions,也要知道插件扩展、Store 互引用和测试 mock 该怎么落地。

技能覆盖什么

本技能按 Pinia v3.0.4 文档结构组织,主要帮你对照实现细节而不是背 API 表:

  • 核心 Store:状态、getters、actions、storeToRefs、订阅
  • 扩展与组合:自定义插件;在 Store 里用 composable;多个 Store 通信与避免循环依赖
  • 工程化:@pinia/testing 单测、在导航守卫/插件等非组件环境使用 Store
  • 进阶:SSR 注水、Nuxt 自动导入与集成、开发期 HMR

文中强调几条容易踩坑的实践:复杂逻辑优先 Setup Store;解构 state/getters 用 storeToRefs();actions 可直接解构;SSR 下在函数内调用 Store 而非模块顶层;为每个 Store 加 HMR。

适用边界

技能面向 Vue / Nuxt 技术栈内的 Pinia 用法,不替代 Pinia 源码或周边生态的完整 changelog。若项目仍大量依赖 Vuex 迁移策略,需结合官方迁移指南与本技能中的 Store 建模建议一起看。

使用场景

  • 新项目用 Composition API,需要把用户信息、权限缓存成可订阅的 Store 并在多个布局组件间共享
  • 在 Vue Router 的 beforeEach 里根据 Pinia 中的登录态决定是否放行,避免在守卫文件顶层直接实例化 Store
  • 为购物车 Store 编写插件,在每次 action 后同步写入 localStorage,并在单测里用 @pinia/testing 替换真实 Store
  • Nuxt 3 页面做 SSR,需在服务端预取 Store 数据并在客户端完成注水,同时保持 HMR 不丢 Store 热更新

适合人员

  • 维护中大型 Vue 3 前端、要把分散的 composable 状态收敛到可测试 Store 的工程师
  • 负责 Nuxt 全栈交付、需在服务端与路由中间件里安全访问同一套 Pinia 状态的开发者
  • 接手遗留页面、要在组件测试里 mock Store 并避免解构 state 丢失响应式的一线开发者
  • 设计多 Store 协作(如用户与订单)且需要规避循环依赖与插件扩展点的技术负责人