Taro3踩坑实录

该文章记录本人在使用taro3开发项目时遇到的一些问题,会持续进行更新

1.实时编译,体积过大,无法预览

问题:使用taro3+vue2.0创建项目,运行--watch时,开发者工具预览时提示体积过大,无法预览

解决思路:首先查找taro3相关文档,看看有无官方解决方法,再和用过该框架开发的同事沟通,看看有无解决方案

解决方法探寻:

1.官方文档对terser的编译配置说明,由于编译命令需根据不同的环境切换,所以无法在--watch时固定设置process.env.NODE_ENV 为 'production'

2.根据同事建议,使用webpack-bundle-analyzer对项目体积进行分析,发现app.js体积高达1.2M,很明显是引入了一些体积大的插件

根据taro3的issue,在package.json里面查看模块,发现taro-ui-vue模块的引入导致体积暴增,由于该项目暂未使用,去除

以下是去除后的分析结果

预览包体积下降了很多,可以进行正常的编译即时预览

可以正常进行预览,但是总包体积仍过于巨大,还需后续持续优化更新

2.不同页面引入同一组件,样式错乱 

解决方案:在 src 下创建 app.scss ,然后在 app.tsx/app.jsx 中引用这个文件就好了

这个问题可能跟开发的习惯有关,有些开发会有引入公共样式的习惯,有些开发没有。如果没有引用公共样式的话,又有代码洁癖的人会把 app.jsx 上引入 的 「import './app.scss」删除,然后问题就会出现。Taro 是在编译后在「app.wxss」用「@import './common.wxss」引入。但是如果我们在 app.jsx 中没有「import './index.scss」,Taro 在编译后也不会生成「app.wxss」,结果就是「common.wxss」也没有被引入了。

建议 Taro 默认都生成一个「app.wxss」避免类似问题

可以参考该issue:https://github.com/NervJS/taro/issues/8168

### Taro 框架 H5 端常见问题与解决方法 #### 一、页面加载速度慢 当在 H5 环境下运行 Taro 应用时,可能会遇到页面加载缓慢的情况。这通常是因为打包后的文件体积过大或是网络请求过多造成的。 对于大文件体积的问题,可以考虑使用代码分割技术来减少初始加载时间。通过 Webpack 的 `splitChunks` 插件配置实现按需加载模块[^1]。另外,压缩资源文件也是提升加载效率的有效手段之一;例如图片可以通过工具进行无损压缩处理后再引入到项目里。 针对频繁发起 HTTP 请求影响体验的情形,则建议合并相似接口调用并合理设置缓存策略以降低服务器压力的同时加快响应速率[^2]。 ```javascript // webpack.config.js 中的部分配置项用于优化构建产物大小 optimization: { splitChunks: { chunks: 'all', minSize: 30000, maxSize: 0, cacheGroups: { vendor: { // 抽离第三方库 test: /[\\/]node_modules[\\/]/, name(module, chunks, cacheGroupKey) { const packageName = module.context.match(/[\\/]node_modules[\\/](.*?)([\\/]|$)/)[1]; return `${cacheGroupKey}.${packageName.replace('@', '')}`; } }, common: { // 提取公共部分 minChunks: 2, priority: -20, reuseExistingChunk: true } } } } ``` #### 二、样式兼容性差异 由于浏览器内核的不同,在开发过程中难免会碰到一些 CSS 属性或 HTML 结构上的跨平台显示效果不一致现象。为了确保良好的视觉呈现质量,应该遵循现代前端最佳实践: - 使用 Reset 或 Normalize.css 来消除默认样式的干扰; - 避免过度依赖特定厂商前缀属性,转而利用 PostCSS 自动补全必要声明; - 对于 flexbox/grid 这类较新的布局方式要特别留意其支持度范围,并准备好降级方案给老旧版本设备[^4]。 #### 三、路由跳转异常 有时会出现点击链接后无法正常导航至目标页面的现象,可能是由以下几个方面引起: - 如果是单页应用(SPA),则需要注意 history API 的正确运用以及 hashchange 事件监听机制是否健全; - 双向绑定框架下的路径参数解析逻辑可能存在漏洞,导致匹配失败进而阻止了预期的行为发生; - 当存在多个同名组件实例共存的情况下,务必保证它们之间的状态隔离以免互相干扰造成混乱局面。 ```javascript import Taro from '@tarojs/taro'; const navigateToPage = (url) => { try { Taro.navigateTo({ url }); } catch (error) { console.error('Navigation failed:', error); } }; ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值