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 参数,可以指定光标与键盘的距离
相关推荐
甜甜的资料库2 小时前
基于小程序老人监护管理系统源码数据库文档
微信小程序
Uyker18 小时前
微信小程序动态效果实战指南:从悬浮云朵到丝滑列表加载
前端·微信小程序·小程序
happyCoder1 天前
uniapp 微信小程序实现定时消息订阅提醒(前后端)
微信小程序
Uyker1 天前
从零开始制作小程序简单概述
前端·微信小程序·小程序
打小就很皮...2 天前
HBuilder 发行Android(apk包)全流程指南
前端·javascript·微信小程序
前端缘梦2 天前
微信小程序登录方案实践-从账号体系到用户信息存储
前端·微信小程序
coding随想2 天前
2025年小程序开发全解析:技术储备、行业趋势与实战案例
微信小程序
Nueuis3 天前
微信小程序前端面经
前端·微信小程序·小程序
轩1153 天前
实现仿中国婚博会微信小程序
微信小程序·小程序
知否技术3 天前
2025微信小程序开发实战教程(一)
前端·微信小程序