VueUse 组合式函数指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vueuse-skills。
技能介绍
你在 Vue 里重复造轮子的问题
在 Vue 3 / Nuxt 项目里,响应式状态、DOM 观测、浏览器 API、网络请求 往往被拆成一堆 ref/watch 和事件监听。同类需求每家写法不同,维护成本高,也容易在 SSR、卸载清理上踩坑。VueUse 已经把这些场景封装成 composable,但函数数量多、命名相近,助手若不清楚规则,容易推荐错函数或当场写一套“差不多”的自定义逻辑。
技能如何帮你做选型与落地
本技能把 需求 → VueUse 函数 → 调用方式 串成固定流程:接到 Vue / Nuxt 相关开发任务时,先判断是否有 VueUse 能直接覆盖,再对照函数表里的 Invocation 字段决定怎么用:
- AUTO:场景匹配即可采用
- EXTERNAL:仅当用户已安装对应外部依赖时再推荐,否则先评估是否真有必要安装
- EXPLICIT_ONLY:只有用户点名时才使用
函数按 State、Elements、Browser、Sensors、Network、Animation、Component、Watch 等类目归类;每个条目有简述,具体用法与类型声明以技能内 ./references 文档为准。整体倾向用 composable 替代手写实现,在可读性、可维护性和性能之间取平衡。
适用边界
- 仅覆盖 VueUse 库内 已列出的函数,不替代完整应用架构设计
- 用户 prompt 或
AGENTS.md中的指令可覆盖默认 Invocation 规则 - EXTERNAL 类函数不应在依赖未安装时默认强推安装
使用场景
- Nuxt 页面要根据 `prefers-color-scheme` 切换主题并持久化,需选用 `useColorMode` 或 `useDark` 而非自写 localStorage 逻辑
- 列表页要做无限滚动,需在 `useInfiniteScroll` 与容器 `useScroll` 之间按 DOM 结构选型
- 表单要 debounce 记录 `ref` 变更历史以便撤销,需对照 `useDebouncedRefHistory` 与 `useRefHistory` 的用法
- SSE 实时推送要用 `useEventSource`,并确认与 `useFetch` 在可中止请求上的分工
适合人员
- 维护 Vue 3 管理后台、经常要写 localStorage/session 同步的业务前端,希望统一用 VueUse State 类函数
- 负责 Nuxt SSR 站点的全栈工程师,需要在服务端安全使用 `useMediaQuery`、`useBreakpoints` 等视口相关 composable
- 做拖拽上传、剪贴板、全屏等媒体交互的组件库作者,想按 Browser/Sensors 类目选对 API 封装
- 在 code review 里反复看到自定义 `fetch`/`WebSocket` 封装的团队 Tech Lead,想推动 Network 类函数的标准用法