结论是必须用 uni-app X + UTS;若仅微信小程序+H5+App三端且性能要求高,传统 uni-app 够用但易踩坑;新项目强制 Vue3 + TypeScript,因组合式 API 和类型系统更适配电商复杂逻辑与响应式需求。

直接说结论:用 uni-app 从零开发电商 App,核心不是“能不能”,而是“要不要立刻上 uni-app X”。如果你要上线微信小程序 + H5 + App 三端,且对性能、支付体验、滚动流畅度有真实要求(比如商品瀑布流、秒杀倒计时、购物车动画),uni-app(传统 WebView 版)够用但会反复踩坑;如果目标是原生安卓/鸿蒙商城,或未来要深度对接系统能力(如后台定位、蓝牙、摄像头直出),必须考虑 uni-app X + UTS。
怎么选技术栈:Vue2 还是 Vue3 + TypeScript?
别犹豫,强制选 Vue3 + TypeScript。所有新项目(包括小兔鲜儿、芋道商城、uni-ecommerce)都已默认采用组合式 API 和类型定义。原因很实际:
-
setup()能把购物车逻辑、规格选择、价格计算等抽成独立useCart、useSku等可复用函数,避免选项式 API 下的 data/methods 混乱 -
ref和computed天然适配购物车数量增减、总价实时重算这类响应式场景 -
interface Product定义商品结构后,调用getProductDetailAPI()返回值自动带类型提示,不会在item.price.toFixed(2)时报 “Cannot read property 'toFixed' of undefined” - HBuilderX 对 Vue3 + TS 的语法校验、真机调试支持已稳定,无需额外配置
pages.json 里 tabbar 配置最容易漏掉的三项
很多新手跑通首页后,发现底部 Tab 切换白屏或图标不显示,问题常出在 pages.json 的细节上:
- 每个
tabBar.list项的pagePath必须和pages/目录下的文件路径完全一致,大小写敏感 —— 比如pages/cart/index.vue对应的pagePath是"cart/index",不是"cart"或"pages/cart/index" -
iconPath和selectedIconPath的路径是相对于static/目录的,且必须是 png 格式(微信小程序不认 jpg)、尺寸严格为 81×81px,否则 iOS 上图标消失 - 如果启用了分包(如把用户中心放进
subNVue或分包目录),主包的tabBar不能引用分包内的页面路径,否则 H5 正常、小程序报 “page not found”
购物车状态管理为什么不能只靠 localStorage?
因为 localStorage 只解决“关掉再打开还在”,但解决不了“多端同步”“并发修改”“跨页面响应”这三件事:
- 用户在小程序加了商品,H5 页面没刷新,购物车数还是 0 ——
localStorage是隔离的,小程序、H5、App 各自一份 - 用户在商品详情页点 +1,同时在购物车页点删除,两个操作都读取旧的
localStorage值再写入,导致最终数量错乱 - 页面 A 修改了
cartItems,页面 B 的v-for不会自动更新 ——localStorage.setItem()不触发 Vue 响应式 - 正确做法是:用
Pinia管理内存态,配合onMounted时从接口拉取最新状态;退出时用watch监听变化并调用updateCartAPI()同步到服务端
真正难的不是写出来,是让购物车在微信小程序里滑动不卡、在安卓 App 里点击按钮有原生反馈、在 H5 上返回时保持滚动位置——这些细节分散在 scroll-view 的 enhanced 属性、button 的 hover-class、onBackPress 生命周期钩子里,没人会专门告诉你,但漏一个,体验就断层。


















