Taro + React + Tailwind 开发微信小程序问题汇总(持续更新中...)

搞小程序也有两周了,踩了很多坑,有些问题很难搜索到,在这里记录一下问题和自己的解决方案,希望能帮助到需要的小伙伴~

1. 真机调试报错:Error: module '@babel/runtime/helpers/Arrayincludes.js' is not defined

  • 真机调试模式从 2.0 切换为 1.0 即可解决
  • 要将【转换为 ES5】勾选掉,因为 Taro 通过 webpack 已经将代码编译为 ES5。

2. Taro 中如何使用 weui?

javascript 复制代码
// app.config.ts 
useExtendedLib: { weui: true, }, 
usingComponents: { 'mp-badge': 'weui-miniprogram/badge/badge'...},

3. Taro 动态设置当前页面的标题

4. app.js错误: Error: module 'common.js' is not defined, require args is './common'

  • 偶现,可以先重启 webpack

5. 小程序样式不生效,tailwind 伪类不生效(hover)

6. Error: module 'vendors.js' is not defined

  • 删掉 node_modules 重装

7. fail api scope is not declared in the privacy agreement

8. taro 中配置的 global.d.ts 引入方式不能使用 import,否则因为在头部引用会导致整个 ts 配置文件失效!

  • 正确引入方式:/// <reference types="@tarojs/taro" />。因为在头部错误使用 import 引入类型,导致 declare module '*.png' 不生效

9. object-fit 在小程序中不生效

10. Taro 引入 weui <mp-dialog>其中bindbuttontap按钮点击事件不生效

  • 需要将 bindbuttontap 改成 onButtontap

11. uploadFile:fail createUploadTask:fail url not in domain list

可能有如下原因:

  • uploadFile 合法域名未配置或配置错误
  • 或者是 url 写错(仔细检查一下,我这边就是 url 传错了,忘记添加 baseurl,因为和 get 与 post一起封装的,但是options没有共用)

12. Taro 如何实现手势放缩图片

  • 注意需要配置 scale 才支持放缩
tsx 复制代码
<MovableArea style='height: 200px; width: 200px; background: red;'>
    <MovableView style='height: 50px; width: 50px; background: blue;' direction='all' scale ></MovableView>
</MovableArea>

13. 小程序使用 <mp-dialog> 时弹窗被键盘遮住

  • 配置 input 组件 cursor-spacing 参数,可以指定光标与键盘的距离
相关推荐
拖孩10 小时前
这个小程序是 AI 帮我写的,可它里面一个 AI 功能都没有
前端·后端·微信小程序
克里斯蒂亚诺更新14 小时前
小程序自定义导航栏怎么写:从配置到实战
微信小程序
liyinchi198814 小时前
微信小程序支付遇到“由于小程序违规,支付功能暂时无法使用” 解决办法
java·微信小程序·go
silianpan16 小时前
Office 文档预览 UTS 插件
android·微信小程序·harmonyos
微笑的曙光16 小时前
第三期 · 账号体系与双 Token 鉴权:让用户「无感登录,有感安全」
微信小程序
耀耀切克闹灬1 天前
Skyline 渲染问题记录以及总结
微信小程序
小程序开发X1 天前
2026 深圳 APP 开发甄选:技术架构搭建、全流程落地、综合选型解读
微信小程序·小程序·app开发
EatFan2 天前
一个二维码背后的系统设计:批次生成、绑定、扫码与数据统计怎么做?
java·后端·微信小程序·二维码·qrcode
微笑的曙光3 天前
第一期 · 本地优先 MVP:不写一个后端,如何做出完整体验
微信小程序
EatFan3 天前
Java接入微信支付保姆式教程(三):SpringBoot 接入微信支付并完成统一下单
微信小程序·微信支付·springboot