第一次做小程序:React Native 和 UniApp,我选错了后悔三天,选对了后悔三年?

手机里躺着四十多个小程序,我第一次觉得,这玩意儿我上我也行。

引子:一个让我失眠的“简单需求”

事情源于一个很朴素的念头:我想给自己做一个打卡小程序。每天早上打开微信,点一下,记录,完事。

听起来简单得不能再简单。于是我打开搜索引擎,输入了那个经典问题:“新手做小程序,用什么技术好?”

然后我看到了两个词,反复出现:React Native 和 UniApp。

我当时的第一反应是:“React Native,Facebook 出的,听起来很牛。UniApp?没听说过。”

但十分钟后,我发现自己可能想错了。

第一章:React Native——那个“看起来更厉害”的选择

React Native(简称 RN)确实是 Facebook 的亲儿子。它的卖点很吸引人:用 JavaScript 写代码,编译出来的是真正的原生组件。

说人话就是:你写的 App,看起来和用 Swift/Java 写的一模一样,因为它底层调用的就是系统的原生按钮、原生列表。

比如写一个按钮:

jsx

<Button title="打卡" onPress={handleCheckIn} />

这个 Button 在 iPhone 上就是 iOS 的原生按钮,在安卓上就是安卓的原生按钮。

性能好,体验好,生态大。 Instagram、Shopify 这些大厂都在用。

但问题来了。

我翻遍了 RN 的文档,发现了一个残酷的事实:

RN 不支持微信小程序。

RN 的目标平台是 iOS 和 Android,偶尔能出个 Web 版,但小程序?不在它的名单里。

这意味着:如果你想做小程序,RN 直接出局。

我当时的心情:就像你走进一家餐厅,发现菜单上只有“西餐”,但你想吃的是“中餐”。

第二章:UniApp——那个“没听说过”的选择

UniApp 是 DCloud 公司做的国产框架。它的口号是:“一套代码,多端发布。”

翻译成人话:你写一遍 Vue 代码,它帮你编译成微信小程序、支付宝小程序、百度小程序、H5 页面、甚至 App。

我一开始觉得这听起来像“万能药”,不太靠谱。但当我看到它的适用场景时,我沉默了:

“仅做国内小程序,无需 App → ✅ UniApp | 开发效率最高,调试便捷,文档齐全”

这说的不就是我吗?

第三章:技术栈——Vue vs React,我选哪个

UniApp 用的是 Vue.js 语法。

而我,一个写过三年 React 的人,对 Vue 的印象还停留在“那个有 v-if 和 v-for 的框架”。

但当我真正开始写 UniApp 代码时,我发现:

它和写普通 Vue 项目几乎一模一样。

vue

<template>
  <view class="container">
    <button @click="handleCheckIn">打卡</button>
  </view>
</template>

<script>
export default {
  methods: {
    handleCheckIn() {
      uni.showToast({ title: '打卡成功' })
    }
  }
}
</script>

uni.showToast 在微信小程序里会自动变成 wx.showToast,在 H5 里会变成自己的实现。

这就是 UniApp 的核心魔法:API 映射。 你写 uni.xxx,编译器帮你翻译成各平台的原生 API。

第四章:那些新手才会踩的坑(我全踩了)

坑一:条件编译的边界

UniApp 允许你用 #ifdef MP-WEIXIN 写微信小程序特有的代码。但我不知道的是,微信开发者工具对条件编译的嵌套层数有限制,超过 5 层就编译报错。

我的第一版代码,嵌套了 7 层。

编译报错的那一刻,我盯着屏幕,开始怀疑自己是不是不适合写代码。

坑二:静态资源路径

在 H5 里,我习惯写 <image src="/static/logo.png">。

在微信小程序里,这行不通,必须用相对路径:<image src="../../static/logo.png">。

我改了三次路径,才让图片显示出来。

坑三:原生组件的“层级诅咒”

微信小程序的 <camera>、<map> 这些原生组件,默认脱离文档流,z-index 完全失效。

我想在相机上面放一个按钮?不行。 按钮会被相机组件盖住,点都点不到。

解决办法是用 cover-view,一个专门用来“盖在原生组件上面”的特殊组件。

我当时的感觉:就像你想在别人家墙上钉钉子,结果发现那面墙是悬浮的。

第五章:备案——那个我差点忽略的“前置条件”

代码写完了,我兴冲冲地打开微信开发者工具,准备预览。

然后我看到了一个提示:该小程序未备案。

2023 年起,微信小程序必须备案才能上线。

我点进备案流程,发现需要:

  1. 小程序名称(不能含“资源”“工具”等通用词)
  2. 主体信息
  3. 服务器域名(如果你有后端 API,必须在这里配置)

备案审核大概需要几天到几周。

我后来学聪明了:备案和开发可以并行。 等备案的日子里,我可以写云函数、画 UI、写文档。

但第一次不知道,硬生生等了三天。

第六章:当我终于跑起来时

备案通过后,我点了“预览”,用微信扫码。

手机屏幕上出现了我写的页面。 一个蓝色的按钮,上面写着“打卡”。

我点了一下。

uni.showToast 弹出了一个小提示:“打卡成功”。

那一刻,我觉得这三天值了。

尾声:一点真实感受

回过头看,如果让我给“第一次做小程序”的自己一个建议,我会说:

如果你只做小程序,选 UniApp。 它专为这个场景设计,Vue 语法对前端友好,多端编译省事,国内文档齐全。

如果你要做高性能 App,选 React Native。 它的原生渲染能力是 UniApp 比不了的。

但如果你和我一样,只是想快速做一个能跑的小程序,别纠结。

UniApp 五分钟就能创建项目,十分钟就能跑起来。

React Native 也可以做小程序,但要绕一大圈。

而我选 UniApp 的原因很简单:我不想为了一个打卡小程序,先学一套原生开发。

Logo

开源鸿蒙跨平台开发社区汇聚开发者与厂商,共建“一次开发,多端部署”的开源生态,致力于降低跨端开发门槛,推动万物智联创新。

更多推荐