uni-app 开发指南

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

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

概述

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

使用场景

使用此技能当：

• 编写 .vue 组件

• 创建 composables（use* 函数）

• 构建客户端工具

• 简洁易懂，复杂的代码配上中文注释

快速参考

正在处理... 加载文件

components/ 中的 .vue

references/components.md

composables/ 中的文件 references/composables.md

utils/ 中的文件 references/utils-client.md

.spec.ts 或 .test.ts

references/testing.md

加载文件

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

• 组件工作 → 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

• 可复用的组合函数