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