用途:指导在 Nuxt 中通过 Vue Composition API 编写可复用的有状态逻辑,适用于构建可复用状态逻辑、共享状态管理或封装特定功能。
主要能力:资料包含 composables.md(模式、命名、状态管理与最佳实践)和 multi-step-state.md(通过 useState 实现 SSR 安全的跨路由共享状态、从 route.path 推导步骤、带副作用的提交、为何由调用方负责 loading)。
状态模式:单例模式将状态定义在函数外部,跨所有调用方共享,示例文件 app/composables/useUser.ts 中 let user = ref<User>() 定义在函数外,返回 { user, setUser, clearUser };工厂模式将状态定义在函数内部,每次调用生成新实例,示例 app/composables/useCounter.ts 中 const count = ref(initial) 在函数内,返回 { count, increment, decrement }。
命名与文件约定:文件名如 useUser.ts、useCategories.ts;函数使用 export default function useUser();返回值始终为对象 { state, methods };refs 使用响应式命名如 user,而非 userRef。
限制:资料未提供安装命令、依赖版本、平台要求、收费信息或具体使用步骤,暂未提供。