生产环境代码压缩需分平台配置:微信小程序须在manifest.json的mp-weixin.optimization中同时启用subPackages和runtimeCompress;H5需开启h5.optimization.treeShaking.enable;App端依赖离线打包Gradle配置或云端自动处理,且所有压缩仅在--mode production下生效。

生产环境代码压缩在 uni-app 里不是“开个开关”就完事,而是分平台、靠配置文件驱动的构建行为,HBuilderX 界面勾选无效,必须改 manifest.json 或 vue.config.js。
微信小程序:必须配 manifest.json 的 mp-weixin.optimization
很多人以为 HBuilderX 里勾选「运行时是否压缩代码」就生效了——其实那只影响开发预览,对正式构建 npm run build:mp-weixin 或 HBuilderX「发行」完全没用。
- 真正起作用的是
manifest.json中mp-weixin节点下的optimization配置 - 必须同时开启两项:
subPackages: true和runtimeCompress: true,缺一不可 -
runtimeCompress不是压缩图片或字体,而是移除 JS 中的注释、空格、未使用的调试逻辑,实测可减 1.2–1.8MB - 如果开了
subPackages: true却没开runtimeCompress,分包 JS 仍会塞进主包 vendor.js,体积照样爆 2MB
H5 平台:manifest.json 开启 treeShaking 即可
H5 构建默认已启用 Terser 压缩,但摇树优化(tree shaking)需要显式打开,否则大量未引用的模块仍会打进 chunk-vendors.js。
- 在
manifest.json的h5节点下添加:"optimization": { "treeShaking": { "enable": true } } - 这个配置对 Vue2 和 Vue3 项目都有效,但只在生产构建(
npm run build:h5)时触发 - 注意:若你用了自定义
vue.config.js并覆盖了configureWebpack,需手动在optimization.minimize中传入 Terser 实例,否则摇树可能被覆盖失效
App(Android/iOS):依赖离线打包时的 Gradle 配置
App 端的代码压缩不走 manifest.json,而是在离线打包阶段由 Android Studio 的 Gradle 控制,云端打包则由 DCloud 后台自动处理。
- 离线打包时,确保
build.gradle中minifyEnabled true和shrinkResources true已启用 - 混淆规则写在
proguard-rules.pro,uni-app 自身的 JS 层代码不会被 ProGuard 处理,但 WebView 加载的 JS 会受runtimeCompress影响(前提是主包构建时已开启) - 如果你用的是 HBuilderX 云端打包,只要
manifest.json里mp-weixin或h5的压缩配置正确,App 端也会继承相同 JS 压缩逻辑
最容易被忽略的一点:所有压缩行为都只在 --mode production 下生效。本地运行 npm run dev:mp-weixin 或 HBuilderX 「运行」时,哪怕配置全对,也不会触发任何压缩——这是设计使然,不是 bug。










