diff --git a/docs/标签页性能-测量结论与执行清单.md b/docs/标签页性能-测量结论与执行清单.md new file mode 100644 index 00000000..2a7d325b --- /dev/null +++ b/docs/标签页性能-测量结论与执行清单.md @@ -0,0 +1,408 @@ +# 标签页性能 · 测量结论与执行清单 + +> 测量对象:`http://localhost:5174/order/orderManagement`(dev server,硬刷新) +> 测量工具:浏览器工具 + `PerformanceObserver(longtask/LCP/CLS)` + CDP `Performance.getMetrics` + CDP `Profiler` +> 测量日期:2026-11-06 +> **本文档只做结论与清单,未改动任何代码。** + +--- + +## 0. 口径说明(先读) + +| 项 | 说明 | +|---|---| +| 环境 | Vite **dev server**(ESM 按模块加载,未打包) | +| 是否限速 | 否(无 CPU/网络节流) | +| "切 tab 耗时"口径 | 从点击到 `.main-container` **连续 350–400ms 无 DOM 变更**。因此数值里**包含约 350–400ms 的静默判定窗口**,绝对值偏高,**只看相对差异** | +| 生产环境差异 | dev 下 246 个 script 请求 / 14.17MB 解码体积,生产打包后会大幅下降;**但"8 个 tab 页被静态 import 进同一路由块"这个结构性问题在生产同样存在** | + +--- + +## 1. 首屏测量结果 + +### 1.1 关键时间点 + +| 指标 | 数值 | 说明 | +|---|---|---| +| TTFB | **314 ms** | 后端首字节 | +| FCP | **576 ms** | 首次内容绘制 | +| DOMContentLoaded | **748 ms** | | +| load | **750 ms** | | +| **LCP** | **3392 ms** | 列表内容出现晚 | +| CLS | 0.029 | 轻微布局抖动 | +| **最长任务** | **1857 ms**(起始 1272 ms) | 主线程被独占近 2 秒 | +| **TBT(总阻塞时间)** | **2333 ms** | 远高于 300ms 良好线 | +| 其它长任务 | 358ms@3317、135ms@3131、90ms@658、63ms@3676 | | + +> 时间线:576ms 首屏骨架 → 1272ms 起一个 1.86s 长任务(页面"卡住")→ 3129ms 结束 → 3392ms 才画出列表内容。**用户体感的"打开慢"就是这一段。** + +### 1.2 资源与 DOM + +| 指标 | 数值 | +|---|---| +| 请求总数 | **250**(script 246 / css 1 / xhr 3) | +| 脚本解码体积 | **14.17 MB**(transfer 仅 0.09MB,本地 dev) | +| `views/order/orderManagement/` 下的模块 | **69 个**(一次性全部加载) | +| DOM 元素(`querySelectorAll('*')`) | **7537** | +| CDP `Nodes` | **22260** | +| 首屏表格实际行数 | 20 | + +**关键事实**:打开 orderManagement 时,**8 个 tab 页(review/pending/exception/outbound/entrust/delivery/deliveryException/archive)及其依赖的 api 模块被一次性加载**(`index.vue:104-113` 全是静态 import + `markRaw`)。这是 1.86s 长任务的主要来源。 + +### 1.3 CPU 采样归因(7 秒窗口) + +| 分类 | 耗时 | +|---|---| +| idle(空闲) | 3077 ms | +| **program(解析/编译/样式/布局/绘制等浏览器内部)** | **1336 ms** | +| garbage collector | 156 ms | +| 最高的单个 JS 帧 | `update2 @ element-plus` 91 ms | +| 其次 | `track`(响应式) 67ms、`getBoundingClientRect` 59ms、`createReactiveObject` 54ms | + +**结论**:长任务**不是某一段业务 JS 卡住**,而是"大量模块解析 + 大 DOM 样式/布局"的累计。因此优化方向是**减少首屏要加载/渲染的量**,而不是找某个函数优化。 + +### 1.4 首屏的其它噪声 + +- 8 个 WebSocket 连接失败:`ws://127.0.0.1:13888 / 5000 / 16888 / 10818 / 9113 / 12705 / 13528 / 8000` 全部 `ERR_CONNECTION_REFUSED`(打印组件、摄像头等本地服务)。 +- 它们在 load 之后异步触发,**不直接阻塞首屏**,但会刷错误、占用连接池、增加控制台噪声。 + +--- + +## 2. 切 tab 测量结果(核心证据) + +### 2.1 依次访问 5 个 tab(`tabCacheMax = 3`,共 8 个 tab) + +| 顺序 | tab | 耗时 | 期间长任务 | +|---|---|---|---| +| 1 | 待处理异常订单(首次) | **2006 ms** | 938ms | +| 2 | 待出库订单(首次) | **1628 ms** | 879ms | +| 3 | 委托外仓订单(首次) | **1313 ms** | 630ms | +| 4 | 配送订单(首次) | **2088 ms** | 1083ms | +| 5 | **回到**待处理异常订单 | **3075 ms** | 1199 + 763 + 636ms | + +> 第 5 次比第 1 次**还慢 1 秒**。这就是 `KeepAlive :max="3"` 小于 8 个 tab 带来的 **LRU 抖动**:第 1 个 tab 早已被淘汰,回来时要重新挂载;同时缓存里还占着 3 个旧组件,内存压力更大。 + +### 2.2 两个 tab 之间往返(都在缓存内) + +| 顺序 | tab | 耗时 | +|---|---|---| +| A1 | 待出库订单(首次挂载) | 1696 ms | +| B1 | 委托外仓订单(首次挂载) | 1548 ms | +| **A2** | 待出库订单(**缓存命中**) | **649 ms** | +| **B2** | 委托外仓订单(**缓存命中**) | **642 ms** | +| **A3** | 待出库订单(**缓存命中**) | **691 ms** | + +**结论:缓存命中确实有效(1.6s → 0.65s,约 2.5 倍)**,但: + +- 0.65s 里包含 350–400ms 的静默判定窗口; +- 而 **CSS 过渡本身固定占约 400ms**(`mode="out-in"` + 0.2s 淡出 + 0.2s 淡入)。 + +也就是说:**缓存命中时,"CSS 动画时长"已经成了主要成本**,与数据加载无关。 + +### 2.3 内存 + +访问多个 tab 后:`performance.memory.usedJSHeapSize ≈ 216 MB`,DOM 仍 7105 元素。 +(对照:刚首屏时 CDP `JSHeapUsedSize` 约 68 MB) + +> 这解释了为什么第 5 次切回会触发 3 个长任务:**重建 + GC**。 + +--- + +## 3. 结论:慢在哪 + +| # | 原因 | 证据 | 影响面 | +|---|---|---|---| +| **C1** | 8 个 tab 页被静态 import,打开即加载 69 个模块 | 250 请求 / 14.17MB / 长任务 1857ms | 首屏 | +| **C2** | 首屏 DOM 2.2 万节点、样式与布局耗时 1336ms | `program` 1336ms、DOM 7537 | 首屏 | +| **C3** | `tabCacheMax=3` < tab 数(8 / 5)→ LRU 抖动 | 第 5 次切回 3075ms > 首次 2006ms | 切 tab | +| **C4** | 过渡动画固定 400ms | 缓存命中仍 0.65s | 切 tab(缓存命中时是主成本) | +| **C5** | 提高缓存后缺少"释放/刷新"配套(见代码) | 各 tab 只在 `onBeforeUnmount` 清理;无 `onActivated` | 提高缓存后暴露 | +| **C6** | 8 个本地 WebSocket 连接失败 | 控制台 8 条 ERR_CONNECTION_REFUSED | 噪声/次要 | + +--- + +## 4. 执行清单 + +> 每项都标了**为什么做(对应哪条证据)**、改动位置、验收标准。 +> 建议按批次执行,批次 1+2 必须成对上线。 + +### 批次 1 · 修缓存策略(P0) + +| # | 事项 | 位置 | 依据 | +|---|---|---|---| +| 1.1 | `tabCacheMax` 默认值 3 → **8**(或按页面 tab 数取最大) | `src/stores/modules/experimental.ts`(`DEFAULT_TAB_CACHE_MAX`) | C3 | +| 1.2 | 支持按页面覆盖缓存上限:`ORDER_PAGE_CONFIG.tabCacheMax`、`WAVE_PAGE_CONFIG.tabCacheMax` | `orderManagement/config/order-common-config.ts`、`waveOrder/config/wave-config.ts` + 两个 `index.vue` | C3(8 tab / 5 tab 需求不同) | +| 1.3 | KeepAlive 内 `:key` 统一为 `:key="activeTab"` | `orderManagement/index.vue:56-59`(当前**没有** key)、`waveOrder/index.vue:74-80` | 避免不同 tab 复用同组件类型时串数据 | +| 1.4 | 单页模式 `` 补 `:max` | `waveOrder/index.vue:93-99` | 与多页模式策略一致 | + +**验收**:`A→B→A` 往返时第二次耗时 ≤ 首次的 50%(当前 1.6s → 0.65s 已达标,改后应同样稳定);8 个 tab 依次访问后回到第 1 个,耗时不再高于首次。 + +--- + +### 批次 2 · 缓存的"配套"(P0,必须与批次 1 同批) + +| # | 事项 | 位置 | 依据 | +|---|---|---|---| +| 2.1 | 切走的 tab 释放大列表:`useOrderListPageCleanup` 从 `onBeforeUnmount` 扩展到 `onDeactivated` | `orderManagement/utils/use-order-list-page-cleanup.ts` + 3 个列表 tab | C5(否则 8 份大列表常驻,实测 216MB) | +| 2.2 | 建单成功回调总线防放大:只让**当前激活 tab** 立刻 `loadData`,其它 tab 打 `dirty` 标记 | `pendingOrder.vue:574`、`exceptionOrder.vue:655`、`reviewOrder.vue:283`(`registerCreateOrderSuccess`) | C5(8 个 tab 全部注册在册 → 一次建单触发 8 次请求) | +| 2.3 | 补 `onActivated` 刷新策略:`dirty` 优先,其次 `lastLoadedAt + 阈值` | 同上 3 个列表 tab | C5(当前缓存后切回永远是旧数据) | +| 2.4 | 交付时明确"全局开关仍是总闸" | `experimental.ts` | 保留回滚能力 | + +**验收**: +- 建单成功 → Network 里**只有 1 个** list 请求; +- 在别的菜单改数据后切回 → 最终一致; +- 访问 5 个 tab 后内存增量 ≤ 100MB(当前 216MB)。 + +--- + +### 批次 3 · 首屏模块拆分(P0) + +| # | 事项 | 位置 | 依据 | +|---|---|---|---| +| 3.1 | 8 个 tab 组件改为**按需加载**:`defineAsyncComponent(() => import('./pendingOrder.vue'))` | `orderManagement/index.vue:104-113` | C1(首屏一次性拉 69 个模块) | +| 3.2 | 首屏默认 tab 保持同步或预加载(避免首屏多一次 chunk 等待) | 同上 | 平衡 | +| 3.3 | `waveOrder` 同样处理 | `waveOrder/index.vue` 顶部 import | C1 | +| 3.4 | 校验分包产物:路由 chunk 体积下降、各 tab 独立 chunk | `npm run build` 输出 | C1 | + +**预期**:首屏加载的 `orderManagement` 模块 69 → 约 10(仅激活 tab 及其依赖),长任务显著下降。 + +**验收**:首屏 LCP 下降;首次切到未访问 tab 允许有一次 chunk 等待(≤200ms 内网)。 + +> ⚠️ 3.1 会让"首次切某个 tab"多一次网络请求。**必须与批次 1 一起评估**:有缓存上限后,每个 tab 只会懒加载一次。 + +--- + +### 批次 4 · 过渡动画(P1) + +| # | 事项 | 位置 | 依据 | +|---|---|---|---| +| 4.1 | `tab-fade` 从 `0.2s` 降到 `0.12s`(或缓存命中时跳过 `out-in`) | 各容器 ` + + diff --git a/src/components/ToolbarButtonGroup/types.ts b/src/components/ToolbarButtonGroup/types.ts new file mode 100644 index 00000000..f3c6a5db --- /dev/null +++ b/src/components/ToolbarButtonGroup/types.ts @@ -0,0 +1,38 @@ +/** + * 工具栏按钮组配置类型 + * + * 从 `views/order/orderManagement/config/order-common-config.ts` 抽离, + * 供 `@/components/ToolbarButtonGroup` 与各页面 `*-config.ts` 共用。 + */ + +export interface ToolbarButtonConfig { + key: string + label: string + dynamicLabelKey?: string + size?: '' | 'default' | 'small' | 'large' + type?: '' | 'primary' | 'success' | 'warning' | 'info' | 'danger' + plain?: boolean + loadingKey?: string + disabledKey?: string + action: string + /** 按钮样式分类(优先级高于 type/plain): + * 'refresh' - 蓝底白字(primary) + * 'setting' - 白底黑字(default) + * 'action' - 白底蓝边框蓝字(primary + plain) + * 'cancel' - 红底白字(danger) + * 不设置则沿用 type/plain */ + category?: 'refresh' | 'setting' | 'action' | 'cancel' + /** 下拉按钮:主按钮点击 action,菜单项使用 dropdownOptions[].action */ + buttonType?: 'default' | 'dropdown' + dropdownOptions?: Array<{ label: string; action: string; divided?: boolean }> +} + +export interface ToolbarApiActionConfig { + action: string + apiMethod: string + payloadKey?: string + confirmText?: string + confirmType?: 'warning' | 'error' | 'info' | 'success' + successText: string + failText: string +} diff --git a/src/components/UpperTable/index.vue b/src/components/UpperTable/index.vue index e0c3caa6..8337f59b 100644 --- a/src/components/UpperTable/index.vue +++ b/src/components/UpperTable/index.vue @@ -1,5 +1,5 @@