核心是路由级懒加载和细粒度异步组件控制以降低首屏JS体积，确保FCP≤2.5秒；优先用Vue Router的import()做路由拆包，辅以defineAsyncComponent管理重型组件，交互触发时手动import更精准。

核心是让首屏不需要的代码不进主包，只在真正用到时才拉取——这能直接压低首屏 JS 体积，把首次内容绘制（FCP）控制在 2.5 秒内。

优先做路由级懒加载

90% 的首屏慢问题，根源在于所有页面组件被打包进一个 chunk。Vue Router 天然支持异步加载，不用额外封装：

• 每个 route 直接写 import()，Webpack/Vite 自动拆出独立 JS 文件，带 hash 和缓存友好命名
• 加 /* webpackChunkName: "user-list" */ 注释，方便调试和长期缓存管理
• 用户访问 /user 才请求 user-list.[hash].js，首页完全不加载它

非路由重型组件用 defineAsyncComponent 精控

弹窗、富文本编辑器、复杂图表这类低频但体积大的组件，适合用 defineAsyncComponent 细粒度管理：

vue-component-analyzer

递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。

下载

• 基础写法：defineAsyncComponent(() => import('./Chart.vue'))
• 带体验优化：可配置 loadingComponent、errorComponent、delay（防闪烁）、timeout（防卡死）
• 全局注册一次，全项目复用；也可局部定义，按需引入

交互触发加载，避免提前 resolve

对点击展开、Tab 切换、权限校验后才显示的模块，推荐手动控制加载时机：

立即学习“前端免费学习笔记（深入）”；

• setup 中用 ref(null) 初始化组件变量，点击时 await import() 并赋值
• 模板用 v-if="Editor" 控制渲染，不占位、不预加载
• 注意：这种方式绕过 defineAsyncComponent 的 loading/error 逻辑，需自行维护状态

避开常见负优化陷阱

异步不是加了就快，几处细节容易适得其反：

• 别在 v-for 或 computed 里反复调用 import()，会触发多次重复请求
• 高频组件（如按钮、输入框）不要异步化，runtime 开销反而更高
• SSR 场景下，服务端需同步解析（Nuxt/Vite SSR 插件已内置支持，无需手动处理）