Taro 小程序开发注意事项(不定期记录更新)

目录

一、Webpack重新编译时间过长

二、图片宽度或高度设置auto无效

三、版本问题

四、小程序缓存的问题

五、小程序开发工具没有自动刷新的问题


一、Webpack重新编译时间过长

解决方案:https://blog.csdn.net/qq_50909707/article/details/158810739

二、图片宽度或高度设置auto无效

html 复制代码
 <Image mode="heightFix" src={LOGOS.PRIMARY} className="h-14" />

width:auto等于设置mode="widthFix"

三、版本问题

截至 2026 年 3 月 8 日,Taro 最稳定、可用于生产环境的版本为 3.6.39 。4.x 版本目前仍处于测试阶段,暂不推荐用于生产项目。

4.x 最大的亮点是支持 Vite 构建,但对现有技术栈的兼容性较差 ,其中最突出的问题是:NutUI 在搭配 Vite 时会出现大量兼容性异常,稳定性无法保证。

查看版本的方法:

bash 复制代码
npm view @tarojs/cli versions

四、小程序缓存的问题

启动小程序时可能会因为缓存而无法直接更新,解决方案是在启动命令里加clear, 如:

javascript 复制代码
"dev:weapp": "cross-env NODE_ENV=development npm run build:weapp -- --clear --watch",

五、小程序开发工具没有自动刷新的问题

小程序开发者工具可能会在项目根目录自动生成 project.private.config.json 文件 ,该文件会影响端口监听,删除此文件即可解决小程序开发者工具不自动刷新的问题。

后续遇到新问题,再到这里记录。

相关推荐
IT_陈寒12 小时前
Redis那个过期删除策略,差点让我线上崩了
前端·人工智能·后端
jianqiang.xue12 小时前
Espressif-IDE进入维护模式:乐鑫把ESP32开发的宝押给VS Code
前端·css·ide
特创数字科技12 小时前
纯本地离线运行的文档脱敏工具(技术分享)
前端·驱动开发·python
心之语歌12 小时前
uni-app uts原生插件开发:uts 与 Kotlin 交互踩坑实录(附解决方案)
前端·后端
再吃一根胡萝卜13 小时前
DSH 插件数据链路:Host 管数据,Client 只管画
前端
feixing_fx13 小时前
CSS 变量(Custom Properties):构建可扩展的主题切换系统
前端·css·前端框架·html·css3
十有八七14 小时前
手搓 Agent(一):先有大脑——大模型只会做一件事
前端·人工智能·后端
锋行天下14 小时前
「踩坑实录」给 LangGraph Agent 接两个 FastMCP,我被 langchain 偷偷改了工具名
前端·人工智能·后端
跳跳的小星星14 小时前
自研组件】Vue2 + ElementUI 通用列表页封装 wkjp-list-page,一套配置搞定搜索、动态表格、分页、增删改
前端
tryCbest14 小时前
Vue3—— 第 18 篇:Vue 2 到 Vue 3 迁移指南——升级避坑全记录
前端·vue.js