uni-app x

本 skill 基于 uni-app x 文档生成，生成日期 2026-01-29。

uni-app x 是下一代 uni-app，跨平台应用开发引擎。包含 UTS 语言、uvue 渲染引擎、uni 组件与 API 及扩展机制。适用于需要为 Agent 提供「如何用 uni-app x 写页面、组件、API、UTS、样式与工程配置」等能力说明的场景。

核心参考

| 主题 | 说明 | 参考 | |------|------|------| | 项目结构 | 新建项目、目录结构、运行与发行 | core-project | | 页面与 uvue | 页面文件、构成、pages.json | core-page | | 页面生命周期 | onLoad、onShow、onReady、onBackPress 等 | core-lifecycle | | App.uvue | 应用入口、应用生命周期、globalData、全局样式 | core-app | | manifest.json | 应用配置、appid、版本、图标、uni-app-x 标识 | core-manifest | | 编译器与静态资源 | 条件编译、static、编译缓存 | core-compiler |

UTS 语言

| 主题 | 说明 | 参考 | |------|------|------| | UTS 概述 | 类型声明、变量/常量、与 TS 的差异 | uts-overview | | 数据类型 | boolean、number、string、Array、UTSJSONObject、type | uts-data-type | | 与 JS 开发差别 | 强类型、data 类型、事件参数类型 | features-codegap | | 条件编译 | #ifdef APP-ANDROID、平台与项目类型判断 | uts-conditional | | 函数与模块 | 函数定义、异常 try-catch、export/import | uts-function-module |

Vue / uvue

| 主题 | 说明 | 参考 | |------|------|------| | uvue 概述 | SFC、template/script/style、组合式与选项式 | vue-uvue | | 组件 | 创建、easycom、手动引用、ref 与 defineExpose | vue-component | | 内置指令 | v-if、v-for、v-show、v-model、v-bind、v-html 等 | features-vue-directives | | 组件标志 | id、ref、UniElement、getElementById、createXXXContext | features-idref | | 组合式 API | ref、computed、watch、reactive、readonly、watchEffect | vue-composition-api | | 数据绑定与修饰符 | 响应式状态、事件修饰符、v-model 修饰符 | vue-data-bind-modifier |

样式 (CSS/ucss)

| 主题 | 说明 | 参考 | |------|------|------| | uvue CSS | flex 布局、样式不继承、选择器与优先级 | css-ucss |

组件与 API

| 主题 | 说明 | 参考 | |------|------|------| | 组件概述 | 内置组件、自定义组件、easycom、uts 组件 | features-component-overview | | API 概述 | uni API、全局 API、原生 API 调用 | features-api-overview | | 路由与跳转 | navigateTo、redirectTo、reLaunch、switchTab、navigateBack、参数传递 | features-navigation | | 本地存储 | setStorageSync、getStorageSync、key-value、对象需 as UTSJSONObject | features-storage | | 页面栈与当前页 | getCurrentPages、UniPage、this.$page、getDialogPages | features-get-current-pages | | dialogPage | 弹窗页、openDialogPage、closeDialogPage、与主 page 区别 | features-dialog-page | | 全局状态 | globalData、专用 store 模块（reactive） | features-global-state | | 长列表与滚动 | scroll-view、list-view、吸顶、嵌套滚动、sticky-header | features-list-scroll | | request 与网络 | 流式响应、cookie、拦截器、泛型与 Task 释放 | features-api-request | | 事件与系统信息 | uni.$on/$emit、getLaunchOptionsSync、getSystemInfo | features-api-event-system-info | | DOM 与 UniElement | getElementById、ref、样式与 draw API、跟手动效 | features-dom | | 表单 form | submit/reset、form-type、子组件与数据提交 | features-form | | 宽屏适配 | leftWindow/rightWindow、页面作组件、窗体通信 | features-adapt | | 国际化 | 多语言、lime-i18n、vue-i18n(Web)、uni.getLocale | features-i18n | | 主题与暗黑 | theme.json、setAppTheme、onAppThemeChange、pages.json 样式 | features-theme-dark | | 编译到 Web | SPA、与 App 差异、refs 类型、SSR 简述 | features-web |

教程与最佳实践

| 主题 | 说明 | 参考 | |------|------|------| | request 联网 | UTSJSONObject 与 type 泛型处理接口数据 | best-practices-request | | 选项式转组合式 | 改造要点、生命周期与 ref 类型 | best-practices-options-to-composition | | 性能优化 | DOM 数量、动画用 transform、长列表与分批加载 | best-practices-performance | | 语言服务与 AI | 语言服务插件、Cursor/VSCode、AI Rules、MCP、AI 修复 | tutorial-ls-ai-rules |

进阶

| 主题 | 说明 | 参考 | |------|------|------| | 原生 SDK 与混合开发 | 嵌入原生工程、导出应用原生资源、集成文档 | advanced-native-sdk |