第一次做小程序:React Native 和 UniApp,我选错了后悔三天,选对了后悔三年?
第一次做小程序: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 年起,微信小程序必须备案才能上线。
我点进备案流程,发现需要:
- 小程序名称(不能含“资源”“工具”等通用词)
- 主体信息
- 服务器域名(如果你有后端 API,必须在这里配置)
备案审核大概需要几天到几周。
我后来学聪明了:备案和开发可以并行。 等备案的日子里,我可以写云函数、画 UI、写文档。
但第一次不知道,硬生生等了三天。
第六章:当我终于跑起来时
备案通过后,我点了“预览”,用微信扫码。
手机屏幕上出现了我写的页面。 一个蓝色的按钮,上面写着“打卡”。
我点了一下。
uni.showToast 弹出了一个小提示:“打卡成功”。
那一刻,我觉得这三天值了。
尾声:一点真实感受
回过头看,如果让我给“第一次做小程序”的自己一个建议,我会说:
如果你只做小程序,选 UniApp。 它专为这个场景设计,Vue 语法对前端友好,多端编译省事,国内文档齐全。
如果你要做高性能 App,选 React Native。 它的原生渲染能力是 UniApp 比不了的。
但如果你和我一样,只是想快速做一个能跑的小程序,别纠结。
UniApp 五分钟就能创建项目,十分钟就能跑起来。
React Native 也可以做小程序,但要绕一大圈。
而我选 UniApp 的原因很简单:我不想为了一个打卡小程序,先学一套原生开发。
更多推荐


所有评论(0)