uni-app 支持通过可视化界面和 vue-cli 命令行两种方式快速创建项目。可视化的方式更为简单直接，因为HBuilderX内置了所需环境，开箱即用，无需额外配置nodejs。
开始之前，请先下载并安装官方IDE：HBuilderX。HBuilderX是通用的前端开发工具，并为 uni-app 开发做了特别强化。
创建uni-app
在HBuilderX中，点击工具栏的“文件”->“新建”->“项目”（或使用快捷键 Ctrl+N），选择 uni-app 类型。随后，输入工程名称、选择合适的模板，点击“创建”即可成功初始化项目。
uni-app自带的模板包括默认的空项目模板、展示官方组件和API的“Hello uni-app”示例模板，以及一个非常重要的“uni ui项目模板”。日常开发推荐使用uni ui项目模板，因为它已内置了大量常用组件。
除了可视化创建，开发者也可以使用 cli 命令行方式创建项目，具体可参考官方CLI文档。两种方式的主要区别在于：HBuilderX创建的项目，其根目录直接就是源码目录，可直接编辑。uni-app的编译器集成在HBuilderX的插件目录中，会随HBuilderX一同升级。如果你更习惯于传统的node项目管理模式，可以查阅文档了解两种创建方式的详细区别。
运行uni-app
创建项目后，可以通过多种方式运行和体验uni-app应用：
- 浏览器运行：在项目中，点击工具栏的“运行”->“运行到浏览器”->选择目标浏览器，即可在Web端预览。
- 运行App到手机或模拟器：使用USB数据线连接手机（确保接口供电充足），在手机设置中开启USB调试并授权电脑调试。然后在项目中点击“运行”->“运行App到手机或模拟器”，即可在设备上安装并运行体验包。如果遇到设备无法识别等问题，可参考常见故障排查指南。如需在苹果手机真机上运行，需注意使用自定义基座。
- 在微信开发者工具里运行：点击“运行”->“运行到小程序模拟器”->“微信开发者工具”。首次使用时，需要先配置微信开发者工具的安装路径，并确保在微信开发者工具的设置中开启了服务端口。
- 在其他小程序工具中运行：同样地，可以运行到支付宝、百度、抖音、QQ、360、京东、快手、飞书等小程序开发者工具中。操作路径类似，均为“运行”->“运行到小程序模拟器”->选择对应平台。
运行注意事项：
- 首次运行时，可能需要在“运行设置”中配置各小程序开发者工具的安装路径。
- 部分小程序工具（如支付宝、百度等）启动后，需手动将HBuilderX控制台提示的项目路径在对应工具中打开。
- 运行的快捷键是
Ctrl+R。HBuilderX还提供了带数字编号的快捷运行菜单，可以快速选择目标设备。
如需进行调试，请参考uni-app的调试文档。
发布uni-app
打包为原生App
在HBuilderX工具栏点击“发行”，选择“原生App-云端打包”。在打开的界面中配置好基础信息后，点击“打包”即可。云端打包支持“安心打包”模式，能保护用户隐私，不会上传源代码和证书。同时也支持CLI命令行模式，便于持续集成。
如果需要离线打包，可以在“发行”菜单中找到“本地打包”选项，生成离线打包资源后，再使用Xcode或Android Studio进行后续操作，具体请参考离线打包文档。注意，如果应用涉及第三方SDK，需要在 manifest.json 中正确配置；iOS App打包则需要提前向Apple申请证书。
发布为Web网站
首先，在 manifest.json 的可视化界面中配置H5的相关设置，例如应用的基本路径（如果发行在网站根目录则可省略）。然后，点击工具栏的“发行”，选择“网站-H5手机版”，HBuilderX会生成H5资源文件并保存于 unpackage 目录。
发布为Web的注意事项：
- 如果使用了
history路由模式，需要后端服务器进行相应配置。 - 打包后的资源，推荐使用uniCloud的前端网页托管服务进行一键部署和CDN加速。
- 若使用传统服务器，建议在服务端开启
gzip压缩以优化性能。
发布为小程序
发布到各大小程序平台的流程基本相似，以下以几个主要平台为例：
- 发布为微信小程序：首先申请微信小程序AppID。在HBuilderX中点击“发行”->“小程序-微信”，输入小程序名称和AppID后发行。你可以在
unpackage/dist/build/mp-weixin目录找到生成的代码，并导入微信开发者工具进行上传审核。如果勾选了“自动上传微信平台”，则无需手动操作。 - 发布为百度/支付宝/抖音等小程序：流程类似，均需先在对应平台申请小程序账号和AppID（部分平台如支付宝无需填写AppID）。然后在HBuilderX的发行菜单中选择对应平台（如“小程序-百度”）。发行后，将生成在相应平台目录（如
mp-baidu）的代码导入对应开发者工具，测试无误后提交上传，最后在平台后台提交审核即可。 - 发布为其他小程序：对于QQ、快手、飞书、京东、小红书等平台，发布流程与上述平台一致，在发行菜单中选择对应选项即可。
- 发布为快应用：分为“快应用联盟”和“华为快应用”两条渠道，需分别入驻。在HBuilderX中选择对应发行选项后，将生成的代码导入各自的开发工具进行构建和上传。
- 发布为鸿蒙元服务：需要先注册鸿蒙元服务并获取AppID。在HBuilderX中点击“发行”->“鸿蒙元服务”，工具会自动构建并上传到开发者后台，后续操作可跟随控制台提示的链接完成。
发布的快捷键是 Ctrl+U，同样可以通过快速发布菜单进行选择。