---

name: uniapp description: 用于编辑 .vue 文件、创建 uni-app 组件、编写 composables - 提供 Composition API 模式、props/emits 最佳实践、VueUse 集成以及响应式解构指导 license: MIT

uni-app 开发指南

uni-app Composition API 模式、组件架构实践的参考指南。

当前稳定版本： uni-app 基于 Vue 3.4.21，不要使用 Vue 3.5+ 的新特性。

概述

uni-app 项目的渐进式参考系统。仅加载与当前任务相关的文件，以最小化上下文使用（基础约 250 tokens，每个子文件 500-1500）。

使用场景

使用此技能当：

• 编写 .vue 组件
• 创建 composables（use* 函数）
• 构建客户端工具
• 简洁易懂，复杂的代码配上中文注释

快速参考

加载文件

根据文件上下文一次加载一个文件：

• 组件工作 → references/components.md
• Composable 工作 → references/composables.md
• Utils 工作 → references/utils-client.md
• 测试 → references/testing.md

不要一次加载所有文件 - 会浪费上下文在不相关的模式上。

可用指导

references/components.md - 响应式解构的 Props、emits 模式、defineModel 用于 v-model、slots 简写

references/composables.md - Composition API 结构、VueUse 集成、生命周期钩子、异步模式

references/utils-client.md - 纯函数、格式化器、验证器、转换器、何时不使用 utils

示例

resources/examples/ 中的工作示例：

• component-example.vue - 包含所有模式的完整组件
• composable-example.ts - 可复用的组合函数