Vue 3 项目的性能表现通常被拆成两类问题:一类是打包后的资源是否过大,另一类是页面在真实设备上的加载与交互是否顺畅。性能预算要做的,就是把这两类问题转成可以在构建、测试、发布阶段自动校验的数字阈值。它和代码规范的最大区别是,规范往往依赖人工审查,而预算可以写入 CI 流程,一旦体积或延迟指标越过红线,合并请求直接失败。

要实现这一点,不能只盯首屏 JavaScript 体积。还应该把路由包、第三方依赖、CSS、图片格式以及 Web Vitals 指标纳入同一套预算体系。下面从指标选择、构建层配置、自动化断言和真实用户监控四个角度展开。
一、先分清资源类预算和体验类预算
资源类预算关注构建产物的物理体积,例如初始 JavaScript、CSS、字体和图片。它更容易在 CI 中精确测量。体验类预算关注加载完成后的用户感受,例如 LCP、CLS 和 INP,这些指标受网络、设备、代码执行时长共同影响,不能只看打包体积。Vue 3 项目建议同时设置两类预算,但不要把它们混为一谈。
资源预算可以先从两个数字开始:首屏加载的 gzip 后 JavaScript 总量控制在 200 kB 以内,单个路由分包尽量不超过 60 kB。这样并不是要求所有页面都极简,而是避免用户打开首页时被迫下载整站逻辑。Vue 3 的组合式 API 本身具备较好的 tree-shaking 能力,但如果入口文件一次性 import 了大量组件、指令或工具函数,这种优势就会被抵消。可以定期用构建产物分析工具查看 dist 目录中的大块依赖,尤其关注图表、富文本编辑器、日期库等容易被低估的包。
体验类预算则要结合真实用户数据。Lighthouse 提供的实验室数据适合做上线前卡点,但不能替代真实用户监控。例如某台低端安卓手机的网络延迟会让 LCP 明显偏高,实验室环境可能完全测不出来。因此体验预算通常分成两档:实验室阈值用于 CI 拦截,现场阈值用于告警与趋势分析。Vue 3 项目可以将 LCP 的 CI 断言设为 2500 ms,CLS 设为 0.1,INP 设为 200 ms,同时在上线后统计 75 分位用户的真实值,若连续三天超过预算就触发告警。
二、在 Vite 构建阶段设置体积预警与分包策略
Vue 3 项目多使用 Vite,它默认会对大于 500 kB 的 chunk 给出警告。这个默认值对于中后台应用偏宽松,可以根据项目的网络目标调整为 200 kB。配置方式是在 vite.config.js 中设置 build.chunkSizeWarningLimit。更重要的是通过 manualChunks 把稳定且体积较大的依赖拆成独立包,让浏览器缓存命中率更高。
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
export default defineConfig({
plugins: [vue()],
build: {
chunkSizeWarningLimit: 200,
rollupOptions: {
output: {
manualChunks: {
vue: ['vue', 'vue-router', 'pinia'],
charts: ['echarts'],
utils: ['lodash-es']
}
}
}
}
})
上面的配置把 Vue 核心生态、图表库和通用工具拆开。注意 manualChunks 不是解决体积问题的万能手段,它只是改变加载顺序和缓存边界。如果 echarts 只在报表页面使用,更好的做法是结合路由懒加载,让报表页面的依赖只在该路由被访问时下载。Vue 3 的 defineAsyncComponent 也能完成组件级别的异步加载。
import { defineAsyncComponent } from 'vue'
const ReportPanel = defineAsyncComponent(function () {
return import('./components/ReportPanel.vue')
})
export default {
components: {
ReportPanel
}
}
拆分完成后还需要持续检查单包体积。可以用 size-limit 在本地或 CI 中为 dist/assets 下的 JS 和 CSS 设置硬限制。它支持 gzip 和 brotli,也比人工查看构建日志更可靠。下面是一个 package.json 片段。
{
"scripts": {
"size": "size-limit"
},
"size-limit": [
{
"path": "dist/assets/*.js",
"limit": "220 kB",
"gzip": true
},
{
"path": "dist/assets/*.css",
"limit": "60 kB",
"gzip": true
}
]
}
这里将全部入口 JS 的总和限制在 220 kB,CSS 限制在 60 kB。实际项目中如果你的首屏依赖多个异步 chunk,需要调整通配符或拆成多个规则,避免把不需要首屏加载的报表逻辑也算进预算。更精细的做法是按路由定义预算,例如 home、report、admin 分别配置不同的上限,这样体积增加时可以立刻定位到具体页面。
三、用 Lighthouse CI 把体验指标变成合并门槛
资源体积只能间接反映加载速度,最终的体验指标需要借助 Lighthouse 或 WebPageTest 这类工具。Lighthouse CI 可以直接读取上面的构建产物,在无头浏览器中运行性能审计,并根据预设断言决定命令是否成功。把这一步接入 Pull Request 流程,就能避免性能退化进入主分支。
先安装 @lhci/cli,然后在项目根目录创建 lighthouserc.json。下面配置对性能总分、FCP、LCP、CLS 和 TTI 做了断言。
{
"ci": {
"assert": {
"assertions": {
"categories:performance": ["error", {"minScore": 0.9}],
"first-contentful-paint": ["error", {"maxNumericValue": 1800}],
"largest-contentful-paint": ["error", {"maxNumericValue": 2500}],
"cumulative-layout-shift": ["error", {"maxNumericValue": 0.1}],
"interactive": ["error", {"maxNumericValue": 3800}]
}
}
}
}
这份配置的含义是:性能总分类得分不能低于 0.9,FCP 不能超过 1800 ms,LCP 不能超过 2500 ms,CLS 不能超过 0.1,TTI 不能超过 3800 ms。任何一项不达标,Lighthouse CI 都会以错误状态退出。开发人员可以在合并请求中看到具体是哪个指标超了以及对应的审计项,不需要再手动画性能报告。
在 GitHub Actions 中,可以先构建再运行 lhci autorun。命令会自动上传结果到临时公开存储或本地目录,并根据 lighthouserc.json 的断言返回结果。具体步骤可以这样写。
name: Performance Budget
on: [pull_request]
jobs:
lighthouse:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
- run: npm ci
- run: npm run build
- run: npx lhci autorun
这类 UI 自动化测试需要一定的运行时间,通常放在普通单元测试之后。为了避免网络波动造成误报,可以在断言中给 LCP 等指标留出 5% 到 10% 的余量,也可以在同一 Job 中运行三次取中位数。不过上限值一旦写在配置文件里,就不要因为单次失败而直接调高,而应先分析是不是新增了未拆分的依赖、同步请求或大型渲染逻辑。
四、采集真实用户数据并建立趋势告警
CI 中的 Lighthouse 只能代表实验室环境,真实用户设备的性能分布会更复杂。建议在应用入口注册 web-vitals,把 Core Web Vitals 指标发送到已有的监控平台或自建接口。Vue 3 项目不需要把这些代码塞进组件生命周期,直接在 main.js 中注册即可,避免路由切换造成重复采集。
import { createApp } from 'vue'
import App from './App.vue'
import { onCLS, onINP, onLCP, onFID, onTTFB } from 'web-vitals'
function sendMetric(metric) {
const payload = {
name: metric.name,
value: metric.value,
rating: metric.rating,
delta: metric.delta,
id: metric.id
}
if (navigator.sendBeacon) {
const blob = new Blob([JSON.stringify(payload)], { type: 'application/json' })
navigator.sendBeacon('/api/vitals', blob)
}
}
onCLS(sendMetric)
onINP(sendMetric)
onLCP(sendMetric)
onFID(sendMetric)
onTTFB(sendMetric)
createApp(App).mount('#app')
这段代码不会阻塞渲染,sendBeacon 在页面卸载时仍能发送数据。服务端收到指标后可以按页面、设备类型、网络类型分组,统计 75 分位值。预算告警不要只看平均值,因为少数极慢用户会拉高均值,而中位数又可能掩盖长尾问题。75 分位是业务监控中相对实用的折中方案,既能反映多数用户的体验,也能比中位数更早暴露性能退化。
真实用户监控还有一个重要作用:验证实验室预算是否合理。假设 CI 中 LCP 一直稳定在 2200 ms,但线上 75 分位用户已经达到 4 秒,说明实验室环境缺少真实网络或设备差异。此时可以引入 WebPageTest 的多区域测试,或者把 CI 断言收紧,同时在告警系统中设置 7 天环比阈值。例如 LCP 75 分位较上周上升超过 15%,就自动创建性能缺陷工单。
预算不是一成不变的规则。每次项目增加核心功能、更换 UI 库或支持新的低端设备时,都应该重新审视阈值。调整预算要走变更流程,说明原因、数据来源和影响范围。把性能预算当作工程质量的一部分,而不是性能优化活动结束后就搁置的文档,才能让 Vue 3 应用在持续迭代中保持可接受的加载与交互体验。
Vue 3性能预算工程化监控Web Vitals修改时间:2026-11-01 11:52:19