uni-app首屏加载慢主因是主包冗余，关键在三处对齐：manifest开启subPackages优化、pages.json与preloadRule路径严格一致、packages与subPackages的root完全匹配。
uni-app 首屏加载慢，八成是因为主包塞了太多不该在首屏出现的东西。分包不是“配了就快”，按需引入也不是“加个 import 就行”——关键在三处对齐：manifest 开关、pages.json 路径、preloadRule 的 root 值。漏掉任意一个，预加载就静默失效。
manifest.json 必须开启 subPackages 优化开关
这是最容易被跳过的一步，也是所有分包预加载的前提。没有它，preloadRule 就是废配置，连控制台日志都不会触发下载动作。
- 微信/百度/QQ 小程序：必须在
manifest.json的mp-weixin（或对应平台）节点下加："optimization": {"subPackages": true} - App 端（iOS/Android）：同样需要在
app-plus节点下配"optimization": {"subPackages": true}，否则 App 启动时仍加载整包 - H5 端不识别该配置，填了也忽略——别白费劲
- 如果用了自定义构建或 uni-app x，确认你编辑的是最终生效的 manifest（HBuilderX 中右键项目 → “manifest.json” → 源码视图）
pages.json 的 subPackages 和 preloadRule 路径必须严格一致
路径写错一个字符，预加载就断掉。uni-app 不做模糊匹配，只认 pages.json 中定义的**绝对路径字符串**（不含开头斜杠，带后缀）。
-
preloadRule的 key 必须是pages.json里pages或subPackages中出现的完整路径，例如："pages/index/index"，不能写成"index/index"、"pages/index"或"/pages/index/index" -
packages数组里的值，必须和subPackages中的root字段**完全一致**，比如：{"root": "subpkg/user", "pages": [...]}→packages: ["subpkg/user"]，不能简写为"user"或补全为"./subpkg/user" - TabBar 页面必须在
pages数组中，不能只放在subPackages里，否则小程序启动失败 - 真机调试时，在开发者工具「网络」面板搜索
preloading或downloadSubNVue，确认是否真正发起请求
按需引入要区分场景：页面级 vs 组件级 vs 工具函数
“按需引入”不是万能膏药，不同层级的引入方式、时机和收益差异很大。盲目拆，反而增加 JS 解析开销。
- 页面级：用
uni.preloadPage({url: '/subpkg/user/profile'})替代直接uni.navigateTo，适合用户大概率跳转的页面（如首页 → 个人中心），但要配合network: "wifi"先验证逻辑 - 组件级：首屏页面中非关键组件（如分享按钮、评论列表）用
import()动态引入，延迟到onLoad或onShow后执行，避免阻塞渲染：onShow() { setTimeout(() => { import('@/components/share.vue').then(...); }, 500); } - 工具函数：禁止在
App.vue的onLaunch中全量引入大库（如date-fns），改用命名导入：import { format, parseISO } from 'date-fns'，避免打包进主包 - 注意：nvue 页面不支持
import()异步组件，要用require或提前注册全局组件
独立分包适合高频单点入口，但限制极多
如果你有某个页面（比如活动页、客服页）需要“秒开”，且它基本不依赖主包资源，独立分包是更激进的选择。但它不是普通分包的升级版，而是隔离更强、约束更严的运行环境。
- 必须在
subPackages中显式声明independent: true，且该分包内不能引用主包的js、components、plugins、app.css等任何资源 - 独立分包的样式必须自包含，
app.vue里的全局样式对其无效 - 从独立分包页面启动小程序时，主包不会被下载——这对扫码直达场景友好，但也会导致登录态、全局 store 初始化缺失，需自行处理
- 调试时容易误以为“页面白屏”，其实是因样式/JS 加载失败，建议先关掉独立分包，确认功能正常后再启用
最常被卡住的地方，从来不是怎么写 preloadRule，而是根本没开 optimization.subPackages；最影响体验的，也不是分包没拆完，而是把骨架屏、字体、图标这些本该内嵌的资源，还傻傻走网络请求。优化不是堆配置，是砍冗余、控时机、验效果。
