iOS安装包超大主因是未关调试符号、未启运行时压缩、未剥离冗余架构,而非代码量多;须检查Frameworks、Assets.car、JS文件体积,并在manifest.json启用runtimeCompress及禁用Swift支持。

直接结论:iOS安装包超大,90%是因为没关调试符号、没启用运行时压缩、没剥离未用架构,而不是代码本身写得多。
检查 unpackage/app-ios 目录下真实产物体积
别信 HBuilderX 构建日志里那句“构建完成”,它不反映真实 IPA 内容。打包后立刻打开 unpackage/app-ios 目录,用 macOS 的「列表视图 + 按大小排序」扫一眼:
-
Payload/xxx.app/Frameworks/里有没有libswiftCore.dylib这类动态库?有就说明 Swift 支持被全量打入——除非你真用了 Swift 原生插件,否则必须关掉 -
Payload/xxx.app/Assets.car占比是否异常高?那是图片资源未压缩或含 alpha 通道的信号 -
Payload/xxx.app/main.js和common/vendor.js是否超过 4MB?说明第三方库没按需引入,或分包优化没生效
必须在 manifest.json 中启用 runtimeCompress
这是 iOS 包瘦身最硬核的一环。很多人只配了 "subPackages": true,却漏掉 runtimeCompress,结果 JS 里全是注释、空格、未用的 polyfill 和调试逻辑,白占 1.5MB+。
在 manifest.json 的 app-plus 节点下加:
{
"app-plus": {
"optimization": {
"runtimeCompress": true
}
}
}
注意:runtimeCompress 不是“压缩图片”,而是移除 JS 中的冗余字符和未执行分支,实测对 iOS 包体减幅达 1.2–1.8MB。它和 subPackages 是两件事,不能互相替代。
禁用 Swift 支持与精简 ABI 架构
iOS 打包默认会带上所有 ABI 架构(arm64、arm64e、x86_64),还可能误打 Swift 运行时。这些在真机上根本用不到,只会让 IPA 变胖。
- 进 HBuilderX → 项目右键 → “App原生插件配置” → 关闭
Swift Support(除非你写了 Swift 插件) - 在
manifest.json的app-plus下加:"nvueStyleCompiler": "uni-app"(避免旧版编译器带入冗余样式逻辑) - 云打包无法控制 ABI,必须本地打包;Xcode 构建时,在 Build Settings →
Excluded Architectures加x86_64和arm64e(仅保留arm64)
图片资源必须提前压缩且禁用 alpha 通道
iOS 对图标和启动图要求极严:App Store 要求 1024×1024 图标无透明度、无圆角;Assets.car 里一张带 alpha 的 PNG 就能撑大 300KB+,而 WebP 或压缩 PNG 能压到 1/4。
- 用
sharpCLI 批量处理:sharp *.png --no-alpha --quality=80 - 图标导出时在 Sketch/Figma 中关闭「透明度」选项,确保 alpha 通道为 0
- 启动图不要放
static/下再引用,改用 Xcode 的LaunchImage或LaunchScreen.storyboard方式加载,避免被 Webpack 二次打包
复杂点在于:runtimeCompress 开启后若出现白屏,大概率是 Promise 或 Object.assign 缺失 polyfill;此时不能全局引入,得在 main.js 顶部加 import 'core-js/stable',但要搭配 babel-preset-env 的 useBuiltIns: 'usage',否则又会把整个 core-js 打进去。











