PiniaVue状态管理Skill pinia

---

name: pinia description: Pinia 是 Vue 的官方状态管理库，类型安全且可扩展。用于定义存储、处理状态/获取器/操作，或在 Vue 应用中实现存储模式。 metadata: author: Anthony Fu version: “2026.1.28” source: 从 https://github.com/vuejs/pinia 生成，脚本位于 https://github.com/antfu/skills

Pinia

Pinia 是 Vue 的官方状态管理库，旨在直观且类型安全。它支持选项式 API 和组合式 API 风格，具有一流的 TypeScript 支持和开发者工具集成。

该技能基于 Pinia v3.0.4，生成于 2026-01-28。

核心参考

主题	描述	参考
存储	定义存储、状态、获取器、操作、storeToRefs、订阅	core-stores

特性

可扩展性

主题	描述	参考
插件	通过自定义属性、状态和行为扩展存储	features-plugins

可组合性

主题	描述	参考
可组合函数	在存储中使用 Vue 可组合函数（如 VueUse 等）	features-composables
组合存储	存储间通信，避免循环依赖	features-composing-stores

最佳实践

主题	描述	参考
测试	使用 @pinia/testing 进行单元测试，模拟和存根	best-practices-testing
组件外使用	在导航守卫、插件、中间件中使用存储	best-practices-outside-component

高级

主题	描述	参考
SSR	服务器端渲染，状态水合	advanced-ssr
Nuxt	Nuxt 集成，自动导入，SSR 最佳实践	advanced-nuxt
HMR	开发中的热模块替换	advanced-hmr

关键建议

• 优先使用 Setup Stores 用于复杂逻辑、可组合函数和侦听器
• 使用 storeToRefs() 当解构状态/获取器时以保持响应性
• 操作可以直接解构 - 它们绑定到存储
• 在函数内调用存储 而非模块作用域，特别是对于 SSR
• 添加 HMR 支持 到每个存储以提升开发体验
• 使用 @pinia/testing 进行带有模拟存储的组件测试