mcpField
P
pinia

pinia

github.com/antfu开发6.0k19.9k 次安装5 天前更新
代码仓库

关于 pinia

为 Vue 应用状态管理提供参考与建议的 Pinia 技能,涵盖 Store、插件、组合、测试、SSR、Nuxt 和热模块替换,并介绍 TypeScript 与 devtools 支持。

主要功能

  1. 01Store 定义、状态、Getter 和 Action
  2. 02插件与 Store 组合
  3. 03测试及在组件外使用
  4. 04SSR、Nuxt 与 HMR 指南
  5. 05响应式 Store 使用建议

适用场景

  1. 01规划 Vue 应用中的状态管理
  2. 02组合 Store 并使用组合式函数
  3. 03通过模拟状态测试 Store
  4. 04在 Nuxt 或 SSR 中管理 Store

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/antfu/skills --skill pinia

安装后在 Claude Code 中输入/pinia确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

GENERATION.md
references/
advanced-hmr.md
advanced-nuxt.md
advanced-ssr.md
best-practices-outside-component.md
best-practices-testing.md
core-stores.md
features-composables.md
features-composing-stores.md
features-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 StoresStore 之间的通信,避免循环依赖features-composing-stores

最佳实践

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

进阶

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

关键建议

  • 复杂逻辑、composables 和侦听器优先使用 Setup Stores
  • 解构 state/getters 时使用 storeToRefs(),以保持响应性
  • actions 可以直接解构——它们已绑定到 store
  • 在函数内调用 store,而不是在模块作用域中调用,尤其是在 SSR 场景下
  • 为每个 store 添加 HMR 支持,以获得更好的开发体验
  • 使用 @pinia/testing 为使用模拟 store 的组件编写测试

评论

支持 Markdown