uni-app · DCloud 出品的 Vue.js 跨端开发框架｜一套代码发布到 App/小程序/Web 的开发部署全指南

项目仓库： https://github.com/dcloudio/uni-app

定位：用 Vue.js 开发所有前端应用 · 支持平台：iOS / Android / 鸿蒙 / Web / 各类小程序 / 快应用 / 鸿蒙元服务 · 分支：uni-app（vue2/vue3）与 uni-app x（主分支） · 官方文档：doc.dcloud.net.cn

1 项目简介

uni-app 是一个用 Vue.js 开发所有前端应用的框架：开发者编写一套代码，可发布到 iOS、Android、鸿蒙、Web（响应式）以及微信 / 支付宝 / 百度 / 抖音 / 飞书 / QQ / 快手 / 钉钉 / 淘宝 / 京东 / 小红书等小程序、快应用、鸿蒙元服务等多个平台。DCloud 公司拥有上千万开发者、数百万应用与数万款 uni-app 插件。

1.1 核心信息一览

项目项	内容
项目名称	uni-app
仓库地址	github.com/dcloudio/uni-app
项目定位	基于 Vue.js 的跨端开发框架
出品方	DCloud
版本	uni-app（老一代，js 逻辑 + web-view 渲染）与 uni-app x（新一代，原生渲染，主分支）
跨平台	iOS / Android / 鸿蒙 / Web / 多端小程序 / 快应用
官方文档	doc.dcloud.net.cn/uni-app-x

1.2 适用场景

一套代码同时发布到 App、各家小程序与 Web。
想用 Vue 声明式写法做小程序 / App，而非厂商私有语法。
追求 AI 友好（vue/js/ts/css）开发方式。

1.3 能力边界（官方口径）

uni-app x 在 view/text 性能测试中，Android/iOS/鸿蒙三端渲染速度为原生 2~3 倍；长列表帧率为原生 2~4 倍。
uts 是类 ts 跨平台语言：Android 编译为 kotlin、iOS 编译为 swift、鸿蒙 next 编译为 ArkTS、Web/小程序编译为 js。

2 功能特性

一套代码多端运行：App / 小程序 / Web / 快应用 / 鸿蒙元服务。
Vue 生态：沿用 Vue 模板与生态。
uni-app x 高性能原生渲染：比原生 view 体系更优。
AI 友好：提供 AI 开发工具与 uni-agent。
插件生态：数万款插件市场。

3 官方界面预览

uni-app 是开发框架；产出为各端应用。官方 README 附一套代码同时运行到 iOS 模拟器、Android 模拟器、Web、微信 / 支付宝 / 百度 / 抖音 / QQ 开发者工具的多端运行效果图。

4 官方跳转链接汇总

类别	链接	说明
仓库主页	https://github.com/dcloudio/uni-app	源码
官方文档	doc.dcloud.net.cn/uni-app-x	uni-app x 文档
hello 示例	github.com/dcloudio/hello-uniapp	示例代码
Android 评测	benchmark vapor-android	性能报告
iOS 评测	benchmark vapor-ios	性能报告
鸿蒙评测	benchmark vapor-harmony	性能报告

5 前置要求与服务器配置

5.1 软件前提

HBuilderX（DCloud 官方 IDE）或 Vue CLI 工具链。
各端小程序开发者工具 / App 调试环境。

5.2 硬件建议

普通开发机即可；无服务器运行时。

5.3 端口与资源

开发预览有本地 dev server；无生产服务器。

6 方式一：HBuilderX 可视化创建（推荐）

用 DCloud 官方 HBuilderX 新建 uni-app x 项目，选择模板，一键运行到各端模拟器 / 小程序开发者工具。

7 方式二：CLI / 示例工程

从 hello-uniapp 获取示例工程，用 CLI 运行到目标端。

8 配置项说明

项目 pages.json、manifest.json 配置各端页面、权限与 app 信息。

9 常用运维命令

运行 / 发行到各端：按官方文档在 HBuilderX 或 CLI 中执行。

10 常见故障排查

端差异：查官方文档与各端评测报告。

11 风险与合规说明

本文整理自官方 README，命令以官方文档最新说明为准；不包含 star 数等动态数据。

uni-app：DCloud 出品的 Vue.js 跨端开发框架｜一套代码发布多端应用部署指南