uniapp怎么使用：优先用HBuilderX开箱搭建项目直接开发

入行前端半年，接手跨端小项目的时候，实打实弄懂uniapp怎么使用，全程没有跟风配复杂环境，踩的全是新手无脑照搬教程的低级错误。

最开始图省事，直接下载VSCode搭配插件启动uniapp项目，光是环境依赖、编译器适配就折腾了整整一下午，扫码预览一直白屏，控制台一堆莫名的兼容报错，删重装插件三次，问题半点没解决。身边同组新人全都这么操作，都说VSCode自定义快捷键好用，跟风照搬之后，纯纯浪费开发时间。

后来才反应过来，uniapp官方适配最优工具从来不是VSCode。

不用额外配置环境。这是最省心的一点，官网下载标准版HBuilderX，安装完成点开内置插件市场，一键安装uniapp官方插件，不用手动配置node版本，不用全局安装cli脚手架，省去大半新手配置步骤。

新建项目只点三个按钮。打开软件左上角文件，点击新建项目，选中uniapp通用项目，随便命名项目文件夹，勾选默认vue2模板就行，vue3模板适配部分老旧插件兼容性很差，新手没必要强行选用。点击创建，十秒左右项目就自动生成完毕，目录全部标准化，不用手动改基础配置。

直接真机预览调试。顶部工具栏找到运行选项，手机打开开发者模式、开启USB调试，数据线连接电脑，直接运行到安卓设备，一秒拉起手机页面。也可以直接运行内置微信小程序模拟器，自动调取微信开发者工具，不用手动配置小程序appid路径，工具之间会自动互通。

一个极易被忽略的操作误区。很多新手创建项目后，直接修改pages首页代码，保存后页面不刷新，还以为是代码写错反复自查。其实是没打开项目热重载，顶部运行菜单里勾选项目热编译，改动代码后手机、模拟器页面会实时更新，省去反复重启项目的时间。

做简单跨端适配不用额外写代码。原生写小程序、APP要分别写样式兼容，使用uniapp开发，写一套基础view、text标签，自带适配规则，字体、边距会自动适配微信小程序、安卓APP两端，只需要个别异形手机，加一行专属css兼容代码即可。

上周帮同事调试项目，他执意用cli命令行创建uniapp项目，光是命令行下载依赖网速卡顿、版本冲突就卡了两小时，项目启动后还存在路由跳转失效的问题。对比下来，普通业务开发，完全没必要用命令行模式启动项目。

没必要深究底层原理。新手刚开始使用，不用弄懂打包编译逻辑，写完业务代码，直接点击顶部发行，按需打包小程序代码、安卓基座包，工具自动打包，不用手动输入打包指令。

傍晚关掉编辑器的时候，桌面还放着下午打印的VSCodeuniapp配置教程纸。