Agent Skills
返回列表
💻

Vue Pinia 最佳实践

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vuejs-ai-skills-vue-pinia-best-practices。

技能介绍

你会碰上的典型问题

在 Vue 3 项目里把全局状态交给 Pinia 之后,很多问题不会出现在文档首页,而是集中在启动阶段、模板里怎么读 store、以及筛选条件要不要进 URL这几类场景。例如应用一启动就报 `getActivePinia was called,setup 写法开的 store 在 DevTools 或 SSR 里看不到完整 state;在组件里解构 store.user 后界面不再更新,或在模板里直接写 store.fetch() 时 this` 丢失;列表页的筛选在刷新后丢失,多人也无法通过链接复现同一视图。

技能覆盖的能力与用法

本技能按 Store 搭建、响应式、状态模式 三条线整理可对照的 best practices 与 gotcha,并指向更细的子主题(如 pinia-no-active-pinia-error、pinia-store-destructuring-breaks-reactivity、state-url-for-ephemeral-filters 等)。

  • Store Setup:Pinia 实例激活顺序、在 Nuxt/SSR 下挂载 pinia、setup store 需 return 全部 state 以便 DevTools 与序列化一致。
  • Reactivity:避免对 store 做会破坏引用的解构;在模板中调用 store 方法时注意绑定(括号调用 vs 解构方法)。
  • State Patterns:临时 UI 筛选与可分享状态的分层;中大型应用里用 Pinia 约束状态边界,减少「无 DevTools Convention」的野生长状态。

把它当作决策索引:先描述你的症状,再按章节对照 pattern 名称,在实现或 Code Review 时统一团队说法。

适用边界

技能偏重 模式与陷阱说明,不替代 Pinia 官方 API 文档,也不包含具体业务 store 的完整实现代码。若问题出在非 Pinia 层(路由守卫、请求缓存、组件局部 ref),需结合对应模块排查。

使用场景

  • 新接手的 Nuxt 项目在首屏报 getActivePinia,需要按文档顺序核对 app 与 pinia 插件注册
  • 列表页筛选项刷新即丢失,产品要求分享链接保留筛选,需区分 URL 状态与组件内临时状态
  • Code Review 时发现多处对 store 解构赋值导致界面不更新,要统一团队可接受的取值写法
  • setup 语法定义的 store 在 Vue DevTools 里 state 不全,需对照 return 是否暴露全部响应式字段

适合人员

  • 维护中大型 Vue 单页应用、需要统一全局状态边界的业务前端工程师
  • 负责 Nuxt/SSR 项目状态水合与启动报错排查的全栈或前端开发者
  • 带 Pinia 新项目做架构评审的技术负责人,希望用固定 pattern 名约束 Code Review
  • 从 Vuex 迁移到 Pinia、需要对照常见坑清单避免重复踩坑的资深 Vue 开发者