---
name: uniapp
description: uni-app 跨平台应用开发框架。适用于使用 Vue 语法开发 App、H5、各端小程序时的能力与用法。
metadata:
  author: hairy
  version: "2026.1.29"
  source: Generated from https://gitcode.com/dcloud/unidocs-zh, scripts located at https://github.com/antfu/skills
---

# uni-app

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

uni-app 是基于 Vue 的跨平台应用开发框架，一套代码可编译到 App、H5、微信/支付宝/百度等小程序。适用于需要为 Agent 提供「如何用 uni-app 配置项目、写页面与组件、使用路由与 API、注意跨端差异」等能力说明的场景。

## 核心参考

| 主题 | 说明 | 参考 |
|------|------|------|
| 入口 main.js/uts | 入口文件、代码时序、插件与路由 | [core-main](references/core-main.md) |
| App.vue | 应用生命周期、globalData、全局样式 | [core-app](references/core-app.md) |
| pages.json | 页面路由、globalStyle、tabBar、easycom | [core-pages](references/core-pages.md) |
| 页面生命周期 | onLoad、onShow、onReady、onHide、onUnload | [core-lifecycle](references/core-lifecycle.md) |
| manifest.json | 应用配置、版本、超时、各端配置 | [core-manifest](references/core-manifest.md) |
| 条件编译 | #ifdef/#ifndef、平台标识、多端差异化 | [core-conditional-compilation](references/core-conditional-compilation.md) |
| 样式与布局 | rpx/px 单位、预处理器、nvue 差异 | [core-syntax-css](references/core-syntax-css.md) |
| 分包配置 | subPackages、preloadRule、主包与分包 | [core-subpackages](references/core-subpackages.md) |

## 能力参考

| 主题 | 说明 | 参考 |
|------|------|------|
| API 概述 | uni API、Promise 化、各端特色 API、canIUse | [features-api-overview](references/features-api-overview.md) |
| 路由与跳转 | navigateTo/redirectTo/reLaunch/switchTab、传参、EventChannel、窗口动画 | [features-router](references/features-router.md) |
| 组件概述 | 基础组件分类、公共属性、easycom、扩展组件 | [features-component-overview](references/features-component-overview.md) |
| 自定义组件 | slot、ref、父子通信、defineExpose | [features-vue-components](references/features-vue-components.md) |
| Vue 基础 | 单文件结构、数据绑定、事件、列表与条件渲染 | [features-vue-basics](references/features-vue-basics.md) |
| 页面栈与通讯 | getCurrentPages、uni.$emit/$on/$off | [features-window-communication](references/features-window-communication.md) |
| 下拉与触底 | onPullDownRefresh、onReachBottom、start/stopPullDownRefresh | [features-pulldown](references/features-pulldown.md) |
| 定时器 | setTimeout、setInterval、clearTimeout、clearInterval、销毁时清理 | [features-timer](references/features-timer.md) |
| 网络请求 | uni.request、上传下载、超时与中断 | [features-request](references/features-request.md) |
| 网络状态 | getNetworkType、onNetworkStatusChange、offNetworkStatusChange | [features-network](references/features-network.md) |
| 上传与下载 | uploadFile、downloadFile、formData、多文件 | [features-upload-download](references/features-upload-download.md) |
| WebSocket | connectSocket、SocketTask、onOpen/onMessage/send/close | [features-websocket](references/features-websocket.md) |
| 数据缓存 | setStorage/getStorage、本地持久化 | [features-storage](references/features-storage.md) |
| 剪贴板 | setClipboardData、getClipboardData | [features-clipboard](references/features-clipboard.md) |
| 键盘 | hideKeyboard、onKeyboardHeightChange、offKeyboardHeightChange | [features-keyboard](references/features-keyboard.md) |
| 启动参数 | getLaunchOptionsSync、getEnterOptionsSync、path/query/scene | [features-launch-options](references/features-launch-options.md) |
| 授权与设置 | authorize、getSetting、openSetting、scope 列表 | [features-authorize](references/features-authorize.md) |
| 交互反馈 | showToast、showLoading、showModal、showActionSheet | [features-ui-prompt](references/features-ui-prompt.md) |
| 拦截器 | addInterceptor、removeInterceptor、回调与返回值改写 | [features-interceptor](references/features-interceptor.md) |
| 节点信息 | createSelectorQuery、boundingClientRect、scrollOffset、in(component) | [features-nodes-info](references/features-nodes-info.md) |
| 节点相交 | createIntersectionObserver、relativeTo、observe、disconnect | [features-intersection-observer](references/features-intersection-observer.md) |
| 表单 | form 组件、report-submit、@submit、@reset、form-type | [features-form](references/features-form.md) |
| 图片 | chooseImage、previewImage、getImageInfo、saveImageToPhotosAlbum | [features-media-image](references/features-media-image.md) |
| 视频与音频 | chooseVideo、createVideoContext、getRecorderManager、createInnerAudioContext、getBackgroundAudioManager | [features-media-video-audio](references/features-media-video-audio.md) |
| 文件 | saveFile、getSavedFileList、openDocument、getFileSystemManager | [features-file](references/features-file.md) |
| 位置与地图 | getLocation、chooseLocation、openLocation、位置更新、createMapContext | [features-location](references/features-location.md) |
| 画布 | createCanvasContext、CanvasContext、canvasToTempFilePath | [features-canvas](references/features-canvas.md) |
| 导航栏与 TabBar | setNavigationBarTitle、setTabBarItem、hideTabBar、setTabBarBadge | [features-navigation-tabbar](references/features-navigation-tabbar.md) |
| 媒体查询与胶囊按钮 | createMediaQueryObserver、getMenuButtonBoundingClientRect、setBackgroundColor | [features-ui-extras](references/features-ui-extras.md) |
| 动画 | createAnimation、animation.export、组件 animation 属性、pageScrollTo | [features-ui-animation](references/features-ui-animation.md) |
| 字体与单位 | loadFontFace、rpx2px、upx2px | [features-font](references/features-font.md) |
| 语言与主题 | getLocale、setLocale、onLocaleChange、onThemeChange | [features-locale-theme](references/features-locale-theme.md) |
| 系统信息 | getSystemInfo、getDeviceInfo、getWindowInfo、getAppBaseInfo | [features-system-info](references/features-system-info.md) |
| 设备能力 | 振动、scanCode、makePhoneCall、getBatteryInfo、onMemoryWarning | [features-system-device](references/features-system-device.md) |
| 应用级事件 | onPageNotFound、onError、onAppShow、onAppHide | [features-application-events](references/features-application-events.md) |
| 页面预加载 | preloadPage、unPreloadPage（App-nvue、H5） | [features-preload-page](references/features-preload-page.md) |
| 登录/支付/分享/推送 | login、getUserInfo、requestPayment、share、getProvider、push 概述 | [features-plugins-overview](references/features-plugins-overview.md) |
| 其它 API | getAccountInfoSync、getEnvInfoSync、getUpdateManager、navigateToMiniProgram、exit、nextTick、base64 | [features-other-apis](references/features-other-apis.md) |
| H5 宽屏适配 | topWindow、leftWindow、rightWindow、getTopWindowStyle、setTopWindowStyle | [features-h5-adapt](references/features-h5-adapt.md) |

## 进阶参考

| 主题 | 说明 | 参考 |
|------|------|------|
| nvue | 原生渲染、与 vue 差异、requireNativePlugin | [advanced-nvue](references/advanced-nvue.md) |
| renderjs | 视图层 JS、App 端操作 DOM、echarts 等 | [advanced-renderjs](references/advanced-renderjs.md) |
| subNVues | App 原生子窗体、getSubNVueById、getCurrentSubNVue | [advanced-subnvue](references/advanced-subnvue.md) |
| Worker | 多线程、各端实现差异 | [advanced-worker](references/advanced-worker.md) |

## 最佳实践

| 主题 | 说明 | 参考 |
|------|------|------|
| 跨端注意 | 标签与样式、JS/API 差异、工程与配置、常见异常 | [best-practices-cross-platform](references/best-practices-cross-platform.md) |