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 参数,可以指定光标与键盘的距离
相关推荐
打瞌睡的朱尤3 小时前
微信小程序126~160
微信小程序·小程序
腾讯云云开发4 小时前
小程序成长计划正式接入Hy3 preview
微信小程序
bruce541105 小时前
讲讲 RTMate (WebSocket as A Service)中的消息的发布订阅机制
后端·微信小程序
ZC跨境爬虫7 小时前
模块化烹饪小程序开发日记 Day2:全局配置与 tabBar 实现
java·前端·javascript·微信小程序·html·notepad++
好赞科技7 小时前
2026年医院预约小程序三大精选:解锁智慧医疗新体验
大数据·微信小程序
ZC跨境爬虫7 小时前
模块化烹饪小程序开发日记 Day1:项目初始化与模块化目录设计
前端·javascript·ui·微信小程序·音视频
double_eggm1 天前
微信小程序6
微信小程序·小程序
戈伊2 天前
独立开发纪实:我如何用 Gemini CLI 和 Claude Code 打造一个“100% 含 AI 量”的小程序
微信小程序·ai编程
StarChainTech2 天前
先享后付,正在悄悄改变电商的“信任游戏”
大数据·人工智能·游戏·微信小程序·小程序·软件需求
無名路人4 天前
uniApp 小程序 vue3 app.vue静默登录其他页面等待登录完成方式二
前端·微信小程序·ai编程