关于 pinia
为 Vue 应用状态管理提供参考与建议的 Pinia 技能,涵盖 Store、插件、组合、测试、SSR、Nuxt 和热模块替换,并介绍 TypeScript 与 devtools 支持。
主要功能
- 01Store 定义、状态、Getter 和 Action
- 02插件与 Store 组合
- 03测试及在组件外使用
- 04SSR、Nuxt 与 HMR 指南
- 05响应式 Store 使用建议
适用场景
- 01规划 Vue 应用中的状态管理
- 02组合 Store 并使用组合式函数
- 03通过模拟状态测试 Store
- 04在 Nuxt 或 SSR 中管理 Store
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ antfu/ skills --skill pinia安装后在 Claude Code 中输入/pinia确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
GENERATION.mdreferences/advanced-hmr.mdadvanced-nuxt.mdadvanced-ssr.mdbest-practices-outside-component.mdbest-practices-testing.mdcore-stores.mdfeatures-composables.mdfeatures-composing-stores.mdfeatures-plugins.md详细介绍
Pinia
Pinia 是 Vue 官方的状态管理库,设计直观且类型安全。它支持 Options API 和 Composition API 风格,并提供一流的 TypeScript 支持和 devtools 集成。
此技能基于 Pinia v4.0.3,于 2026-09-25 生成。
核心参考
| 主题 | 描述 | 参考 |
|---|---|---|
| Stores | 定义 store、state、getters、actions、storeToRefs 和订阅 | core-stores |
功能
可扩展性
| 主题 | 描述 | 参考 |
|---|---|---|
| Plugins | 为 store 扩展自定义属性、状态和行为 | features-plugins |
可组合性
| 主题 | 描述 | 参考 |
|---|---|---|
| Composables | 在 store 中使用 Vue composables(VueUse 等) | features-composables |
| Composing Stores | Store 之间的通信,避免循环依赖 | features-composing-stores |
最佳实践
| 主题 | 描述 | 参考 |
|---|---|---|
| Testing | 使用 @pinia/testing 进行单元测试、模拟和存根 | best-practices-testing |
| Outside Components | 在导航守卫、插件和中间件中使用 store | best-practices-outside-component |
进阶
| 主题 | 描述 | 参考 |
|---|---|---|
| SSR | 服务端渲染、状态水合 | advanced-ssr |
| Nuxt | Nuxt 集成、自动导入、SSR 最佳实践 | advanced-nuxt |
| HMR | 用于开发的热模块替换 | advanced-hmr |
关键建议
- 复杂逻辑、composables 和侦听器优先使用 Setup Stores
- 解构 state/getters 时使用
storeToRefs(),以保持响应性 - actions 可以直接解构——它们已绑定到 store
- 在函数内调用 store,而不是在模块作用域中调用,尤其是在 SSR 场景下
- 为每个 store 添加 HMR 支持,以获得更好的开发体验
- 使用
@pinia/testing为使用模拟 store 的组件编写测试
评论
支持 Markdown