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

目录

一、Webpack重新编译时间过长

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

三、版本问题

四、小程序缓存的问题

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

---

一、Webpack重新编译时间过长

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

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

 <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 时会出现大量兼容性异常，稳定性无法保证。

查看版本的方法：

npm view @tarojs/cli versions

四、小程序缓存的问题

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

"dev:weapp": "cross-env NODE_ENV=development npm run build:weapp -- --clear --watch",

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

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

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