diff --git a/docs/layout-性能优化分析.md b/docs/layout-性能优化分析.md new file mode 100644 index 00000000..280b3798 --- /dev/null +++ b/docs/layout-性能优化分析.md @@ -0,0 +1,405 @@ +# Layout 框架性能分析与优化建议 + +> 状态:**阶段 1、2 已实施;阶段 3 部分待定;阶段 4 评估后回滚** +> 范围:首屏加载 + 路由切换响应 +> 基线:`npm run build` 产物实测 + +--- + +## 〇、实施进展 + +| 阶段 | 项 | 状态 | +|---|---|---| +| 1 | 生产环境关闭路由树 `console.log` | ✅ 已完成 | +| 1 | `document.title` 去重 | ✅ 已完成 | +| 1 | `beforeEach` 打印连接加一次性标记 | ✅ 已完成 | +| 2 | 切页过渡去掉离开动画(0.2s → 0,进入 0.12s) | ✅ 已完成 | +| 2 | `TaskView` 标签定位改 `Map`(O(1)) | ✅ 已完成 | +| 2 | 打印运行时移到 mount 之后 | ⏭ 跳过(`startConnections` 依赖已初始化的 runtime,后置会漏连接) | +| 3 | `keep-alive` max 降到 4 | ⏸ 暂缓(会改变业务缓存行为) | +| 3 | `TopMenu` 测量缓存 / `Sidebar` 延迟渲染 | ⏸ 暂缓(收益中低、风险中) | +| 4 | Element Plus 按需引入 | ↩️ **已回滚**,详见下方 | + +### 阶段 4 回滚原因 + +启用 `unplugin-auto-import` + `unplugin-vue-components` 后,类型检查暴露出一批**既有的无效用法**(这些代码在全量注册下一直静默失效): + +- `el-list` / `el-list-item`:Element Plus 不存在该组件(Element UI 2 遗留) +- `type="link"`:Element Plus 的 Button 用 `link` 属性,`type="link"` 非法 +- 若干 `TreeNodeData` / `string | null` 类型不匹配 + +修复这些用法**会改变页面视觉**,超出「性能优化不影响样式」的范围,因此回滚,建议作为独立任务排期。 + +> 依赖 `unplugin-auto-import` / `unplugin-vue-components` 已安装,可留作后续实施。 + +--- + +## 一、现状基线 + +### 1.1 首屏加载资源(index.html 实际引用) + +| 资源 | 体积 | gzip | +|---|---|---| +| `vendor-element-plus.js` | **809 kB** | 256 kB | +| `vendor-VdJDF3fp.js`(其他第三方) | **416 kB** | 140 kB | +| `index.js`(入口 + 应用代码) | **228 kB** | 65 kB | +| `vendor-vue.js` | **210 kB** | 78 kB | +| **JS 合计** | **≈ 1.66 MB** | **≈ 539 kB** | +| `vendor-element-plus.css` | **347.6 kB** | ≈ 40 kB | +| `index.css` + `vendor*.css` | ≈ 60 kB | — | +| **CSS 合计** | **≈ 400 kB** | — | + +✅ 好消息:`vendor-echarts`(1.12 MB)和 `vendor-xlsx`(424 kB)**不在首屏预加载列表**,已是按需加载。 + +### 1.2 渲染与切换链路 + +``` +main.ts +├─ import ElementPlus(全量)+ 全量 CSS ← 首屏最大负担 +├─ import 'virtual:svg-icons-register' (67 个图标内联进入口) +├─ loadServerMessages() (异步 i18n) +├─ initPrinterRuntime() + bindRuntimeEvents() (mount 前同步执行) +└─ app.mount('#app') + +permission.ts(beforeEach) +├─ NProgress.start() +├─ hasGetUserInfo 判断 +│ └─ 否则:getInfo() → generateRoutes() → addRoute() × N +│ + console.log(formatRoutesForLog(...)) × 3 ← 生产环境也执行 +└─ ensurePrinterConnectionsAfterLogin() ← 每次导航都调用 + +AppMain.vue +└─ keep-alive(:include=cachedViews, :max=8) + + transition(mode="out-in", 0.2s) ← 感知延迟 + +TaskView/index.vue +├─ ResizeObserver → 写 --app-header-height +├─ visitedViews v-for + v-memo +├─ moveToCurrentTag():遍历全部标签定位 +└─ onBeforeUpdate 清空 tagsRef + +TopMenu.vue(top-bottom 布局) +└─ 渲染两份菜单 DOM:真实层 + 隐藏测量层 +``` + +### 1.3 已有的良好实践(无需再改) + +- ✅ 路由组件全部 `() => import()` 懒加载(`componentMap`) +- ✅ `keep-alive` 的 `wrapRouteComponent` 修复了 include 匹配失效问题 +- ✅ `router-view :key` 收窄为 `route.name ?? route.path`,同页 query 变化不再重建 +- ✅ 第三方库按库拆分 chunk,升级应用代码时第三方哈希不变,可长期缓存 +- ✅ `tags-view` 已加 `v-memo` +- ✅ `ResizeObserver` 替代轮询式高度同步 +- ✅ echarts / xlsx 不在首屏 + +--- + +## 二、性能瓶颈清单 + +### P0 · Element Plus 全量引入 + +**位置**:`main.ts` + +```ts +import ElementPlus from 'element-plus' +import 'element-plus/dist/index.css' +app.use(ElementPlus) +``` + +**代价**:首屏 JS **809 kB**(gzip 256 kB)+ CSS **347.6 kB**,占首屏 JS 的 **48%**、CSS 的 **87%**。 + +**实际使用情况**:项目里大量组件是 `` 模板标签,全量注册会让所有组件(含几乎不用的 Table/Tree/Cascader/Transfer…)都进入产物。 + +**建议**:改为按需自动引入 + +```ts +// vite.config.ts +import AutoImport from 'unplugin-auto-import/vite' +import Components from 'unplugin-vue-components/vite' +import { ElementPlusResolver } from 'unplugin-vue-components/resolvers' + +plugins: [ + AutoImport({ resolvers: [ElementPlusResolver()] }), + Components({ resolvers: [ElementPlusResolver()] }) +] +``` + +同时 `main.ts` 移除 `app.use(ElementPlus)` 与全量 CSS import(样式由 resolver 按需注入)。 + +> 注意:`ElMessage` / `ElMessageBox` 这类**函数式调用**不会被模板扫描到,需要 `import { ElMessage } from 'element-plus'` 保持显式导入(项目里已经是这样用的,兼容)。 + +**预期收益**:首屏 JS **≈ -350~-450 kB**(gzip -100~-130 kB),CSS **≈ -250 kB**。 + +**风险**:中。需要全量回归一次(尤其是动态渲染的 `h(...)` 用法、`el-config-provider`、`ElLoading` 等指令式组件)。 + +--- + +### P0 · 生产环境仍在格式化整棵路由树 + +**位置**:`permission.ts` + +```ts +console.log('[Router] 动态路由 (后端菜单转换):', formatRoutesForLog(accessRoutes)) +console.log('[Router] 合并后完整路由 (constantRoutes + 动态):', formatRoutesForLog(permissionStore.routes)) +console.log('[Router] Vue Router 实例路由:', formatRoutesForLog(router.getRoutes())) +``` + +`formatRoutesForLog` 会**递归遍历整棵路由树并为每个节点创建新对象**,且执行了 3 次(其中一次还是合并后的全量路由)。 + +**代价**:菜单多时(当前 web_pages 89 + api 264 + 其他端),每次登录 / 整页刷新都要构造 3 份完整对象树,同时产生大量对象占用内存。 + +**建议**: + +```ts +if (import.meta.env.DEV) { + console.log(...) +} +``` + +**预期收益**:登录后首次进入 **-50~150 ms**,并释放可观内存。 + +**风险**:极低。 + +--- + +### P0 · `beforeEach` 每次导航都触发打印连接逻辑 + +**位置**:`permission.ts` + +```ts +if (hasGetUserInfo) { + ensurePrinterConnectionsAfterLogin() // 每次导航都执行 + maybeRetryPrintConnectionsAfterRefresh() + return true +} +``` + +`ensurePrinterConnectionsAfterLogin()` 内部会取 store、检查 `isLoaded`、调用 `startConnections()`(内部虽有幂等标记,但仍有数次函数调用与状态判断)。 + +**建议**:加一次性标记,仅在本会话首次通过守卫时执行: + +```ts +let bootstrapped = false +if (hasGetUserInfo) { + if (!bootstrapped) { bootstrapped = true; ensurePrinterConnectionsAfterLogin() } + ... +} +``` + +**预期收益**:每次切页 **-1~3 ms**(单次不大,但导航频率高)。 + +**风险**:低(需保留 `/redirect` 软刷新后的重连分支)。 + +--- + +### P1 · 切页动画造成的感知延迟 + +**位置**:`AppMain.vue` + +```vue + +``` + +```scss +.tab-fade-enter-active, .tab-fade-leave-active { transition: opacity .2s; } +``` + +`mode="out-in"` 表示**旧页面先淡出 200ms,新页面再淡入 200ms**,用户感知的切换延迟累计约 **400ms**。而 keep-alive 命中时页面其实已经缓存好了,这 200ms 完全是等待。 + +**建议**(按保守程度排序): + +1. 只保留进入动画,去掉离开动画: + ```scss + .fade-transform-leave-active { transition: opacity 0s; } + ``` +2. 或缩短到 100~120ms +3. 进阶:keep-alive 命中时跳过动画(按 `route.meta.noCache` 或首次访问判断) + +**预期收益**:切页感知 **-200~-300 ms**。 + +**风险**:低(纯视觉调整)。 + +--- + +### P1 · `TaskView` 每次切页线性遍历标签 + +**位置**:`TaskView/index.vue` + +```ts +const moveToCurrentTag = () => { + nextTick(() => { + for (const [i, tag] of visitedViews.value.entries()) { ... tagsRef.value[i] ... } + }) +} +``` + +- 每次 `route.fullPath` 变化都线性遍历全部已打开标签 +- `onBeforeUpdate` 会清空 `tagsRef`,随后 Vue 重建 ref 数组 + +**建议**: + +- 维护 `Map`,`moveToCurrentTag` 变成 O(1) +- 用函数式 `:ref="el => tagEls.set(tag.path, el)"` 替代数组 ref + 清空逻辑 + +**预期收益**:标签 20+ 时每次切页 **-3~10 ms**。 + +**风险**:低。 + +--- + +### P1 · `TopMenu` 渲染两份菜单 DOM + +**位置**:`TopMenu.vue` + +```vue +…真实菜单… +
+ …再渲染一份相同菜单… +
+``` + +测量层把**所有一级菜单再挂载一遍**(含 el-menu / el-sub-menu 全套组件实例),只为量取宽度。 + +**建议**: + +1. 短中期:菜单结构(routes)不变时缓存测量结果,避免 `resize` / `locale` / `fonts.ready` 反复触发 `measureItems` 全量重测 +2. 长期:直接用真实层的 `scrollWidth` 与 `clientWidth` 判断溢出,去掉测量层 +3. 至少把测量层降级为**纯 DOM 文本宽度测量**(`canvas.measureText`),不挂载组件 + +**预期收益**:首屏挂载 **-20~40 ms**,内存减少一份菜单实例。 + +**风险**:中(收纳数量计算的准确性依赖测量结果)。 + +--- + +### P1 · `Sidebar` 一次性挂载全部菜单 + +**位置**:`Sidebar/SidebarItem.vue` 递归 + +当前 `web_pages` 有 89 条(含子项),全部一次性渲染成 `el-menu-item` / `el-sub-menu`。 + +**建议**: + +- 折叠状态的子菜单**延迟渲染**:只有父级展开过(`is-opened`)才 `v-if` 渲染 children +- 菜单层级深的页面,首屏 DOM 节点数可减少 40%+ + +**预期收益**:首屏 DOM 挂载 **-30~60 ms**(取决于菜单量)。 + +**风险**:中低(需处理“展开瞬间”的首次渲染)。 + +--- + +### P2 · `document.title` 每次导航写两次 + +**位置**:`main.ts` + +```ts +watch([...frontBrandStore.loaded, siteTitle, router.currentRoute.value.path], () => applyDocumentTitle()) +router.afterEach((to) => applyDocumentTitle(to)) +``` + +`path` 变化时 `watch` 触发一次,`afterEach` 再触发一次,造成重复的 `tMenu` 翻译查找 + DOM 写入。 + +**建议**:只保留 `afterEach`(品牌加载完成的场景另加一次 watch 即可)。 + +**预期收益**:每次导航 **-1~2 ms**。 + +**风险**:低。 + +--- + +### P2 · 启动期同步初始化打印运行时 + +**位置**:`main.ts` + +```ts +initPrinterRuntime() +usePrinterComponentStore(pinia).bindRuntimeEvents() +app.mount('#app') +``` + +在 `mount` 之前同步执行,会推迟首帧。 + +**建议**:移到 `mount` 之后,或用 `requestIdleCallback` 包裹,让首屏优先渲染。 + +**预期收益**:首屏 FCP **-10~30 ms**。 + +**风险**:低(注意事件绑定时序)。 + +--- + +### P2 · `keep-alive` 最大缓存 8 个页面 + +`pageCacheMax` 默认 8。缓存的页面实例持有完整 DOM、表格数据、定时器。 + +**建议**: + +- 把默认值降到 4 +- 对重页面(含大表格/视频/图表的)在路由 `meta` 上标 `noCache` + +**预期收益**:内存占用下降,长时间使用后切换更稳。 + +**风险**:低(业务上会牺牲少量返回体验)。 + +--- + +### P3 · 首屏 CSS 未拆分/未压缩到极致 + +当前 `vendor-element-plus.css` 347.6 kB 是**全量样式**。按 P0 的按需引入解决后,这部分会降到约 80~100 kB。 + +另外建议确认部署侧已开启: + +- gzip / brotli +- `Cache-Control: immutable`(vendor chunk 带哈希,可长期缓存) +- HTTP/2 或 CDN + +--- + +## 三、建议实施顺序 + +| 阶段 | 内容 | 风险 | 预期收益 | +|---|---|---|---| +| **1** | 生产环境关闭路由树 `console.log` | 极低 | 首次进入 -50~150ms | +| **1** | `document.title` 去重 | 极低 | 每次导航 -1~2ms | +| **1** | `beforeEach` 打印连接加一次性标记 | 低 | 每次导航 -1~3ms | +| **2** | 切页动画去掉离开过渡 / 缩短时长 | 低 | 切页感知 -200~300ms | +| **2** | `TaskView` 标签定位改 Map | 低 | 每次切页 -3~10ms | +| **2** | 打印运行时移到 mount 之后 | 低 | FCP -10~30ms | +| **3** | `TopMenu` 测量结果缓存 / 去测量层 | 中 | 首屏 -20~40ms | +| **3** | `Sidebar` 子菜单延迟渲染 | 中 | 首屏 -30~60ms | +| **3** | `keep-alive` max 降到 4 + 重页面 noCache | 低 | 内存下降 | +| **4** | **Element Plus 按需引入** | 中 | 首屏 JS **-350~450kB**、CSS **-250kB** | + +> 阶段 1、2 几乎零风险,可以先做,**不改任何业务逻辑**。 +> 阶段 4 收益最大但需要全量回归,建议单独排期。 + +--- + +## 四、可选:先加观测再优化 + +当前没有任何性能埋点,优化效果无法量化。建议先加最小埋点: + +```ts +// 切页耗时 +router.beforeEach(() => { performance.mark('route-start') }) +router.afterEach((to) => { + performance.mark('route-end') + performance.measure(`route:${String(to.name)}`, 'route-start', 'route-end') +}) +``` + +配合 Chrome Performance 面板,可以直接确认「切页慢」到底是: + +- 路由守卫耗时(P0-2 / P0-3) +- 组件渲染耗时(P1-1 / P1-3) +- 还是首屏资源太大(P0-1) + +--- + +## 五、结论 + +- **首屏慢的主因是 Element Plus 全量引入**(1.66MB 首屏 JS 里占 809kB),这是唯一能带来「量级变化」的优化点 +- **切页慢的主因是 200ms 的 `out-in` 过渡动画 + 每次导航的重复守卫逻辑**,这两项改动小、收益直接 +- 菜单相关的渲染开销(TopMenu 双份 DOM、Sidebar 全量挂载)属于「菜单条目多时才会显现」的次要因素,可作为第三阶段 + +如果只能做三件事:**关掉路由树日志 → 去掉离开过渡动画 → Element Plus 按需引入**。 diff --git a/docs/标签排序与默认页签-统一方案.md b/docs/标签排序与默认页签-统一方案.md new file mode 100644 index 00000000..35c1de2b --- /dev/null +++ b/docs/标签排序与默认页签-统一方案.md @@ -0,0 +1,184 @@ +# 标签排序与默认页签:统一方案(已落地) + +- 日期:2026-11-07 +- 状态:**已实现**(P0–P4 全部完成) +- 目标:把原先散落在页面里的 4 份标签排序逻辑收敛为「1 注册表 + 1 组合式 + 1 渲染组件」,并新增「默认页签」与「全项目统一管理面板」 +- 取代文档:`docs/用户偏好配置-浏览器本地保存方案.md` 中关于「标签排序」的章节(该文档的存储/接口设计已不再适用) + +--- + +## 1. 整体结构 + +``` +src/config/tab-order-registry.ts 唯一注册表(页面 key / 标题 / 分组 / 默认标签 / 旧 scope) +src/utils/tab-order.ts 配置文档读写与归一化(纯函数 + store 适配) +src/composables/useTabOrder.ts 唯一读取/排序/默认页签/保存逻辑 +src/components/TabArea/index.vue 唯一标签渲染组件(含排序入口 + 插槽) +src/components/SortSettingDialog.vue 单页排序弹窗(TabArea 内置入口调用) +src/components/TabOrderDragList.vue 拖拽列表(单页弹窗与全局面板共用) +src/components/TabOrderPanel.vue 全项目标签排序面板(设置中心 →导航→标签排序) +src/components/settings/SettingsDialog.vue 设置中心外壳(左导航 + 右内容) +src/components/UpperTable/index.vue 字段设置工具栏入口 + 全局配置导出/导入 + 故障修复 +``` + +```mermaid +flowchart LR + R[tab-order-registry] --> H[useTabOrder] + S[(userPreference 用户级 scope tabOrder)] --> H + H --> T[TabArea] + H --> P[页面 activeTab / 单页模式默认标签] + T --> D1[SortSettingDialog] + D1 --> H + F[TabOrderPanel] --> S + U[UpperTable 字段设置] --> F + S --> G[全局配置 导出/导入] +``` + +--- + +## 2. 配置存储 + +**位置**:`userPreference` 的「用户级」scope(key = `user_prefs_{userId}`,**不分仓库**)。 + +```jsonc +{ + "tabOrder": { + "value": { + "version": 1, + "orders": { + "order.management": ["pendingOrder", "reviewOrder", "..."] + }, + "defaults": { + "order.management": "pendingOrder" + } + }, + "updated_at": 1762500000000 + } +} +``` + +- `orders[pageKey]`:标签 name 顺序;**不存在该键 = 使用默认顺序** +- `defaults[pageKey]`:默认打开的标签;不存在 = 用页面兜底默认 +- 一个 scope 存全项目,导出/导入/清理都只处理这一处 + +### store 变更(`stores/modules/userPreference.ts`) + +| 新增/调整 | 说明 | +|---|---| +| `globalMap` | 用户级层(读 `user_prefs_{userId}`),与仓库级 `map` 分离 | +| `getGlobal / setGlobal / resetGlobal` | 用户级 scope 读写;`getGlobal` 会回退 `map`(兼容历史上写进仓库 key 的数据) | +| `load()` 迁移调整 | 旧 key → 仓库 key 的迁移**排除** `USER_GLOBAL_SCOPES`(当前为 `tabOrder`),避免产生陈旧副本 | +| `persist / persistGlobal` | 无仓库上下文(两个 key 相同)时合并写入,避免互相覆盖 | + +--- + +## 3. 读取与优先级 + +### 顺序配置 + +1. `tabOrder.orders[pageKey]` +2. 旧 scope(`legacyScopes`,命中后**一次性迁移**进新文档,旧 key 保留) +3. 页面传入的默认顺序 + +### 初始激活标签 + +``` +URL ?tab=(合法) > 用户默认(defaults) > 页面兜底默认 > 排序后第一项 +``` + +- **排序不影响默认**:显式设置过默认就一直用它 +- 默认标签失效(权限/页面改版)时静默回退,不报错 +- 单页模式(`ORDER_PAGE_CONFIG.singlePage` / `WAVE_PAGE_CONFIG.singlePage`)同样使用该默认 + +--- + +## 4. 注册表 + +`src/config/tab-order-registry.ts`:新增页面只需加一条。 + +| 字段 | 作用 | +|---|---| +| `key` | 稳定主键,同时是配置键 | +| `title` / `group` | 全局面板展示与分组 | +| `loadTabs` | 懒加载默认标签(动态 `import()`,不进入主包) | +| `legacyScopes` | 旧配置 key(兼容读取) | +| `matchPaths` | 全局面板高亮当前页的兜底匹配 | +| `enabled` | `false` 时面板内只展示、不可编辑 | + +已注册:订单管理、波次管理、缺货补货、商品管理、库存盘点、通用报表、售后类型、运单管理、退回记录(未接入)、订单汇总、页面模板示例、基础设置、编码管理、工作台管理、打印电脑管理、摄像头管理、录像机管理。 + +### pageKey 与旧 scope 对照 + +| pageKey | 旧 scope | +|---|---| +| `order.management` | `order.tabs.order` | +| `order.wave` | `order.wave.tabs.order` | +| `stock.management` | `stock.tabs.order` | +| `setting.basicManagement` | `setting.basicManagement.tabs.order` | +| 其余 TabArea 页面 | `tab-order:{当时的路由 path}`(动态兼容) | + +--- + +## 5. 页面接入方式 + +```ts +const { orderedTabs, defaultTabName, resolveInitialTab, saveOrder, setDefault, reset } = + useTabOrder('order.management', () => tabs.value, { legacyScopes: ['order.tabs.order'] }) +``` + +- `TabArea` 只需传 `page-key`(排序/入口/弹窗全部内置) +- 页面自己维护 `activeTab`,初始值用 `resolveInitialTab(route.query.tab)` +- 单页模式默认组件用 `defaultTabName` 对应的标签 + +已收敛页面:订单管理、波次管理、商品管理、基础设置(newview)、编码管理,以及全部 TabArea 页面(显式 `page-key`)。 + +--- + +## 6. 标签排序面板 + +- 入口:`设置`(Navbar 头像下拉)或列表页工具栏「字段设置」→ 设置中心 → 左侧「导航 → 标签排序」 +- 左侧:注册表中**标签数 ≥ 2** 的页面(打开时并行懒加载标签数量,加载完成前显示「加载中…」,避免单标签页面闪入闪出);按分组 + 搜索 + 已自定义标记,当前页面用蓝点标记 +- 右侧:拖拽排序 + 圆点设为默认;标题栏常驻显示「默认:XXX」(**用户未设置时也展示页面兜底默认**,便于确认当前生效值);默认行带「默认」标签 +- 保存:一次写入 `tabOrder` 文档;`useTabOrder` 为响应式读取,**保存后页面立即生效** +- 「全部恢复默认」= 清空整个 `tabOrder` 文档(保存时生效) +- 未显式设置默认时不写入 `defaults`,继续跟随页面兜底默认(如订单管理 = 待处理订单) + +### 页面兜底默认 + +注册表 `defaultTabName` 声明,缺省用默认顺序的第一个标签: + +| 页面 | 兜底默认 | +|---|---| +| 订单管理 | `pendingOrder`(待处理订单) | +| 商品管理 | `stockDetail`(另有 combo 路径推断,优先于用户默认) | +| 其他 | 默认顺序第一个 | + +--- + +## 7. 统一配置文件与故障修复 + +- 配置文件已升级为 **`tbyc-config.json`**(分区结构,见 `docs/统一配置文件-tbyc-config.md`) +- 分区:`fieldColumns`(字段设置)、`tabOrder`(标签排序/默认页签)、`display`(界面显示)、`shortcuts`(快捷键) +- 导入策略:**覆盖同名项、保留文件中未涉及的配置**;兼容旧版字段配置导出文件 +- 「故障修复」:清除字段配置、显示设置、快捷键,**以及标签排序/默认页签** + +--- + +## 8. 未纳入改造 + +| 页面 | 原因 | +|---|---| +| `data/returnrecord`(退回记录,6 个标签) | 存在「未保存离开」拦截(`before-leave`),切换需确认,暂不改为 TabArea;注册表中标记 `enabled: false` | +| 各页面内「明细面板」二级标签 | 属于记录明细,不是页面级标签 | + +--- + +## 9. 验证清单 + +1. 老用户(已有 `order.tabs.order` 等配置)进入订单管理/波次/商品/基础设置:顺序保持,且配置被迁移进 `tabOrder` +2. 字段设置 → 标签排序:只列出**可排序(标签 ≥ 2)**的页面;标题栏显示当前默认标签;修改顺序/默认后保存,当前页面**无需刷新**即生效 +3. 单页模式(`ORDER_PAGE_CONFIG.singlePage = true`)渲染的是用户设置的默认标签;未设置时渲染 `pendingOrder` +4. 排序后刷新页面:默认标签不变(排序不影响默认) +5. 导出全局配置 → 清空标签排序 → 导入:顺序与默认恢复 +6. 故障修复:标签排序一并清除 +7. 视觉回归:订单/波次/商品/基础设置/编码的标签栏与改造前一致(34px 标签、激活态圆点、右侧角标/chip 位置) diff --git a/docs/标签页性能-测量结论与执行清单.md b/docs/标签页性能-测量结论与执行清单.md new file mode 100644 index 00000000..3d42f809 --- /dev/null +++ b/docs/标签页性能-测量结论与执行清单.md @@ -0,0 +1,691 @@ +# 标签页性能 · 测量结论与执行清单 + +> 测量对象:`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/TabArea/index.vue b/src/components/TabArea/index.vue new file mode 100644 index 00000000..0503bf39 --- /dev/null +++ b/src/components/TabArea/index.vue @@ -0,0 +1,293 @@ + + + + + + diff --git a/src/components/TabOrderDragList.vue b/src/components/TabOrderDragList.vue new file mode 100644 index 00000000..742527bf --- /dev/null +++ b/src/components/TabOrderDragList.vue @@ -0,0 +1,146 @@ + + + + + + diff --git a/src/components/TabOrderPanel.vue b/src/components/TabOrderPanel.vue new file mode 100644 index 00000000..d7421bc9 --- /dev/null +++ b/src/components/TabOrderPanel.vue @@ -0,0 +1,527 @@ + + + + + + diff --git a/src/components/ToolbarButtonGroup/index.vue b/src/components/ToolbarButtonGroup/index.vue new file mode 100644 index 00000000..03ebe1a2 --- /dev/null +++ b/src/components/ToolbarButtonGroup/index.vue @@ -0,0 +1,414 @@ + + + + + + + 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/MoreSettingsDialog.vue b/src/components/UpperTable/MoreSettingsDialog.vue deleted file mode 100644 index f5b1d001..00000000 --- a/src/components/UpperTable/MoreSettingsDialog.vue +++ /dev/null @@ -1,293 +0,0 @@ - - - - - - diff --git a/src/components/UpperTable/index.vue b/src/components/UpperTable/index.vue index e0c3caa6..1161db2e 100644 --- a/src/components/UpperTable/index.vue +++ b/src/components/UpperTable/index.vue @@ -1,5 +1,5 @@ diff --git a/src/views/afterSale/typelist/config/components/DetailPanel.vue b/src/views/afterSale/typelist/config/components/DetailPanel.vue index 973644ac..0b4c3666 100644 --- a/src/views/afterSale/typelist/config/components/DetailPanel.vue +++ b/src/views/afterSale/typelist/config/components/DetailPanel.vue @@ -186,7 +186,7 @@ function resolveTagType(field: DetailFieldConfig, value: any): string { color: #606266; } -/* 轻量状态文本(与 order/orderManagement/styles/order-sub.scss 的 .ut-status-text 一致) */ +/* 轻量状态文本(与 @/styles/status-text.scss 的 .ut-status-text 一致) */ .ut-status-text { font-size: 13px; line-height: 20px; diff --git a/src/views/afterSale/typelist/index.vue b/src/views/afterSale/typelist/index.vue index d4760524..1ed29dd0 100644 --- a/src/views/afterSale/typelist/index.vue +++ b/src/views/afterSale/typelist/index.vue @@ -1,4 +1,4 @@ - diff --git a/src/views/storage/generalreport/index.vue b/src/views/storage/generalreport/index.vue index 4c0a02fd..064802a2 100644 --- a/src/views/storage/generalreport/index.vue +++ b/src/views/storage/generalreport/index.vue @@ -1,4 +1,4 @@ - @@ -274,18 +259,16 @@ defineOptions({ name: 'BasicManagement' }) import { ref, computed, onMounted, reactive } from 'vue' import { ElMessage, ElMessageBox } from 'element-plus' -import { Sort } from '@element-plus/icons-vue' import { useSettingsStore } from '@/stores/modules/settings' -import { useUserPreferenceStore } from '@/stores/modules/userPreference' -import SortSettingDialog from '@/components/SortSettingDialog.vue' +import { useTabOrder } from '@/composables/useTabOrder' import { useVerticalSplitPane } from '@/composables/useVerticalSplitPane' import ScanBox from '@/components/ScanBox/index.vue' import UpperTable from '@/components/UpperTable/index.vue' -import TabArea from './components/TabArea.vue' +import TabArea from '@/components/TabArea/index.vue' import ColumnCellRenderer from './components/ColumnCellRenderer.vue' import OperationCellRenderer from './components/OperationCellRenderer.vue' -import OrderToolbarButtonGroup from '@/views/order/orderManagement/component/OrderToolbarButtonGroup.vue' -import type { ToolbarButtonConfig as OrderToolbarButtonConfig } from '@/views/order/orderManagement/config/order-common-config' +import OrderToolbarButtonGroup from '@/components/ToolbarButtonGroup/index.vue' +import type { ToolbarButtonConfig as OrderToolbarButtonConfig } from '@/components/ToolbarButtonGroup/types' import { PAGE_CONFIG, tabPages, @@ -309,66 +292,25 @@ import DefinitionFormDialog from './pages/DefinitionFormDialog.vue' // 容器高度 // ============================================================ const settingsStore = useSettingsStore() -const shortcutExpanded = computed(() => settingsStore.shortcutExpanded) const containerHeight = computed(() => - shortcutExpanded.value ? 'calc(100vh - 150px)' : 'calc(100vh - 100px)' + '100%' /* 高度由布局层(.app-router-page 的 flex:1)提供,不再自己算 vh */ ) // ============================================================ // 标签页 // ============================================================ -/** 标签排序(浏览器本地保存,scope=setting.basicManagement.tabs.order) */ -const TAB_ORDER_SCOPE = 'setting.basicManagement.tabs.order' -const preferenceStore = useUserPreferenceStore() -/** 当前标签显示顺序(默认 = tabPages 配置顺序) */ -const tabPagesOrder = ref(tabPages.map((t) => t.name)) +/** 标签排序 / 默认页签(统一由 useTabOrder 负责,配置按账号保存) */ +const { defaultTabName } = useTabOrder( + 'setting.basicManagement', + () => tabPages.map((tab) => ({ name: tab.name, label: tab.label })), + { legacyScopes: ['setting.basicManagement.tabs.order'] } +) -/** 默认 tab 顺序(弹窗选项 / 恢复默认用) */ -const DEFAULT_TAB_OPTIONS = tabPages.map((t) => ({ name: t.name, label: t.label })) -const sortDialogVisible = ref(false) +/** 标签列表(默认顺序;展示顺序由 TabArea 按用户配置重排) */ +const tabList = computed(() => tabPages.map((tab) => ({ name: tab.name, label: tab.label }))) -function openSortDialog() { - sortDialogVisible.value = true -} - -/** 保存标签顺序:按新顺序重排 tabPagesOrder */ -function handleSortSaved(order: string[]) { - applyTabOrder(order) -} - -/** 读取本账号保存的标签顺序并应用;无配置时保持默认顺序 */ -function applySavedTabOrder() { - const saved = preferenceStore.get(TAB_ORDER_SCOPE) - if (!Array.isArray(saved) || !saved.length) return - applyTabOrder(saved) -} - -/** 按给定 tab.name 顺序重排;非法项剔除,缺失项按配置补在末尾 */ -function applyTabOrder(order: string[]) { - const byName = new Map(tabPages.map((t) => [t.name, t])) - const ordered: string[] = [] - for (const name of order) { - if (byName.has(name)) ordered.push(name) - } - for (const t of tabPages) { - if (!ordered.includes(t.name)) ordered.push(t.name) - } - tabPagesOrder.value = ordered -} - -/** 标签列表(按 tabPagesOrder 排序,缺失 tab 按配置补在末尾) */ -const tabList = computed(() => { - const byName = new Map(tabPages.map((t) => [t.name, t])) - const names: string[] = [] - for (const name of tabPagesOrder.value) { - if (byName.has(name)) names.push(name) - } - for (const t of tabPages) { - if (!names.includes(t.name)) names.push(t.name) - } - return names.map((n) => ({ name: n, label: byName.get(n)!.label })) -}) -const activeTabName = ref(tabPages[0]?.name ?? 'tab1') +/** 初始激活标签:用户默认 > 配置第一项 */ +const activeTabName = ref(defaultTabName.value || tabPages[0]?.name || 'tab1') /** 当前激活标签页的完整配置 */ const currentTabConfig = computed(() => { @@ -843,7 +785,6 @@ const upperPaneFullStyle = computed(() => ({ // 初始化 // ============================================================ onMounted(() => { - applySavedTabOrder() void loadStoreOptions() // 预加载报表类型注册清单(报表定义页 type 筛选下拉与表单字段依赖) void loadReportTypeList() @@ -854,8 +795,8 @@ onMounted(() => { diff --git a/src/views/system/setting/printcomputer/components/TabArea.vue b/src/views/system/setting/printcomputer/components/TabArea.vue deleted file mode 100644 index 288ec6f1..00000000 --- a/src/views/system/setting/printcomputer/components/TabArea.vue +++ /dev/null @@ -1,132 +0,0 @@ - - - - - diff --git a/src/views/system/setting/printcomputer/config/components/DetailPanel.vue b/src/views/system/setting/printcomputer/config/components/DetailPanel.vue index b95d610a..1e79a03f 100644 --- a/src/views/system/setting/printcomputer/config/components/DetailPanel.vue +++ b/src/views/system/setting/printcomputer/config/components/DetailPanel.vue @@ -44,7 +44,7 @@ import { ref, watch } from 'vue' import { TAG_RESOLVERS, translate } from '../template-config' import type { DetailSectionConfig, DetailFieldConfig } from '../template-config' -import { getStatusTextClass } from '@/views/order/orderManagement/config/order-common-config' +import { getStatusTextClass } from '@/utils/statusText' defineOptions({ name: 'DetailPanel' }) @@ -112,7 +112,7 @@ function resolveTagType(field: DetailFieldConfig, value: any): string { diff --git a/src/views/system/setting/role/index.vue b/src/views/system/setting/role/index.vue index 78e1fc26..81dff256 100644 --- a/src/views/system/setting/role/index.vue +++ b/src/views/system/setting/role/index.vue @@ -1,4 +1,4 @@ -