微信开发者工具更新到1.06.2504010版本后导致预览报错（超出2MB限制）
🔍 本文记录了微信开发者工具在特定版本中出现的代码包体积超限问题的完整调研过程，包括问题分析、版本对比、根因定位和解决方案。
问题背景
在使用微信开发者工具进行小程序开发时，更新到当前的最新版本v1.06.2504010，遇到了代码包无法预览的问题，本文将详细记录问题的调研过程和解决方案。
报错信息
Error: 代码包大小超过限制,main package source size 2141KB exceed max limit 2048KB
直观看就是主包大小超过了2MB导致无法预览，但是更新开发者工具前是不会出现这个问题的。
环境信息
当前使用版本
- 微信开发者工具: v1.06.2407120
可以正常预览。
测试版本
- 测试版本: v1.06.2409140（这个版本是可正常预览的后一个版本）
- 报错信息:
Error: 代码包大小超过限制,main package source size 2140KB exceed max limit 2048KB
代码相同，但是预览会失败，推测v1.06.2409140-v1.06.2504010之间的版本都会预览失败。
问题调研过程
构建产物分析
主包大小超过2M时，会有编译错误提示，点击查看文件列表可以分析主包中各文件大小。
版本对比分析
通过对比不同版本开发者工具使用相同数据的构建结果发现：
v1.06.2407120 vs v1.06.2409140
- 较新版本的构建产物会多出一些
.wxss文件
控制变量对比
删除字体相关的scss文件，都使用新版本构建，分析产物后发现：
app.wxss中包含scss文件夹下的内容- 单独scss文件夹下的wxss文件是构建过程中多出来的冗余数据
- 因为有两份样式文件，导致主包体积增加超过了2M，导致预览报错
根因分析
通过详细的构建产物对比分析，发现问题的根本原因是：
新版本开发者工具构建时会重复编译样式文件，生成冗余的wxss文件可能导致主包体积超出2MB限制，无法预览。
解决方案
当前方案
- 降级使用: 继续使用微信开发者工具v1.06.2407120版本
- 等待修复: 等待官方后续优化
注意事项
即使没有报主包过大错误的开发者工具可能也会多一些冗余数据，最终会增大主包的体积。
📞 官方反馈结果
将详细的分析步骤反馈到了官方群，次日得到了回复：此问题是开发者工具的bug。
参考资料
总结
- 版本选择: 在遇到构建异常时，可以尝试使用稳定的历史版本
- 问题反馈: 及时向官方反馈问题，有助于问题的快速定位和解决
- 构建分析: 善用开发者工具的构建产物分析功能，有助于定位体积问题
- 版本管控: 在团队开发中建议统一开发者工具版本，避免环境差异
标签: 微信小程序 开发者工具 构建优化 问题调研 技术分享
