diff --git a/docs/跨浏览器性能-分析与优化清单.md b/docs/跨浏览器性能-分析与优化清单.md new file mode 100644 index 00000000..727ec7ca --- /dev/null +++ b/docs/跨浏览器性能-分析与优化清单.md @@ -0,0 +1,198 @@ +# 跨浏览器性能:实测数据、已做优化与待办清单 + +> 背景:同一套前端,在另一台 PC 上用 Edge 打开明显比 Chrome 慢。 +> 本文记录**实测数据**、**已落地的代码优化**、**部署侧待调整项**和**浏览器侧排查清单**。 + +--- + +## 1. 结论先说 + +1. **Edge 与 Chrome 同属 Chromium**,渲染引擎基本一致,代码层面不会「只为 Chrome 优化」。 + 体感差距通常来自三类原因,按影响从大到小: + - **环境**:Edge 的「效率模式 / 睡眠标签页」、硬件加速被组策略关闭、扩展、企业代理 / DoH、版本差异; + - **首屏包体偏大**:弱 CPU 上「解析 JS + 应用 382KB CSS」的耗时会被放大; + - **资源数量多**:产物有 **493 个 JS + 329 个 CSS** 分片,切页时会产生一串小请求, + 弱机 / 有安全软件逐个扫描的环境下,差异被放大。 +2. 所以正确做法是**把首屏关键路径做小 + 减少请求数 + 补齐缓存策略**, + 而不是针对某个浏览器写分支代码。 + +--- + +## 2. 实测数据(2026-11-11,本机 Chrome,线上 `wms.wms.gztbyc.com`) + +登录页(首屏): + +| 指标 | 数值 | +|---|---| +| 协议 | h2(HTTP/2 已启用 ✅) | +| 请求数 | 10 | +| 传输合计 | 400KB(gzip) | +| 解压合计 | 1317KB | +| TTFB | 120ms | +| DOMContentLoaded | 387ms | +| load | 430ms | + +首屏三个关键资源(gzip 后):`index.js` 147KB、`vendor-vue.js` 112KB、`index.css` 54KB。 + +构建产物(`npm run build-only`): + +| 项 | 数值 | +|---|---| +| 文件总数 | 822 | +| JS 分片 | 493(合计 6284KB,未压缩) | +| CSS 分片 | 329(合计 1723KB,未压缩) | +| `index.css`(Element Plus 全量样式 + 全局样式) | **382KB** | +| 入口 `index.js` | 465KB → 优化后 **404KB**(gzip 150KB → 137KB) | + +线上响应头现状: + +``` +Cache-Control: max-age=43200 # 12 小时(带 hash 的资源本可以 1 年 + immutable) +Content-Encoding: gzip # 已开启 ✅(无 brotli) +HTTP/2 # 已开启 ✅(curl 探测不到不代表没有,浏览器实测 h2) +Alt-Svc: h3=":443" # 已通告 HTTP/3 +``` + +--- + +## 3. 已落地的代码优化 + +### 3.1 入口 chunk 瘦身:把 400+ 条目的 `import.meta.glob` 拆出首屏 + +- 文件:`src/router/index.ts`、新增 `src/router/view-glob.ts` +- 原因:`import.meta.glob('@/views/**/*.vue')` 会在构建期展开成一张 400+ 条的映射表 + 以及每条懒加载的依赖表,全部打进**入口 chunk**,而实际只有「后端菜单的 component + 路径在 `componentMap` 里查不到」时才会用到。 +- 做法:拆成独立模块 `view-glob.ts`,在 `loadViewModules()` 里**按需 `import()`**; + 菜单推断分支改为「先同步查 `componentMap`,未命中再走 glob 兜底」。 +- 效果:入口 465KB → 404KB(gzip −13KB),首屏少解析 ~70KB JS。 + +### 3.2 替换 `path-browserify` + +- 文件:新增 `src/utils/path.ts`,改 `layout/component/TaskView/index.vue`、 + `layout/component/Sidebar/SidebarItem.vue` +- 原因:全仓只用到了 `path.resolve(base, sub)`,却把 15.5KB 的 CJS polyfill 静态带进了入口。 +- 效果:入口再减 ~15KB,并去掉 `process` 垫片依赖。 + +### 3.3 去掉逐帧 / 全属性过渡带来的抖动 + +- `src/styles/index.scss`:移除 `text-rendering: optimizeLegibility` + (CJK 下排版收益≈0,弱 CPU 上有额外字形计算开销)。 +- `src/styles/transition.scss`:面包屑 `transition: all .5s` → + `opacity/transform` + 0.28s,避免 `all` 把 `left/top/width` 纳入过渡触发 layout。 + +### 3.4 后台标签页停止轮询 + +- `src/layout/component/Navbar.vue`:工单角标 30s 轮询改为 `document.hidden` 时跳过, + `visibilitychange` 回到前台补一次。避免 Edge「睡眠标签页 / 效率模式」与 Chrome + 后台节流策略不同导致的请求堆积。 + +### 3.5 增加可对比的性能探针 + +- 新增 `src/utils/perf-probe.ts`,`main.ts` 里安装(**默认关闭**)。 +- 开启:访问地址加 `?perf=1`,或控制台 `localStorage.setItem('__perf_probe','1')` 后刷新。 +- 输出:协议版本、TTFB / FCP / DCL / load、请求数与各类资源传输量、 + 长任务(卡顿)统计、CPU 核数 / 内存 / DPR / UA。 +- 用法:在两台机器上分别打开 `?perf=1`,复制控制台 JSON 对比, + 能直接判断是「网络慢」还是「CPU 卡」。随时可用 `__perfReport()` 重测。 + +--- + +## 4. 部署侧待调整(收益最大,需要服务器/Nginx 配置权限) + +> 以下都不改动业务代码,但会显著影响「首次打开 / 隔天首次打开」的速度。 + +### 4.1 带 hash 的静态资源改长缓存 + +现在 `max-age=43200`(12 小时)。带内容 hash 的文件可以安全地长缓存: + +```nginx +location ^~ /assets/ { + # 文件名含 hash,内容变了文件名就会变 → 可以放心 immutable + add_header Cache-Control "public, max-age=31536000, immutable"; + access_log off; + try_files $uri =404; +} + +# 入口 HTML 必须每次校验,否则发版后用户仍加载旧资源 +location = /index.html { + add_header Cache-Control "no-cache"; + try_files $uri =404; +} +``` + +收益:隔天首次打开不再对 30+ 个分片发条件请求(304 也要一次往返), +弱网 / 高延迟下有肉眼可见差别。 + +### 4.2 开启 Brotli(比 gzip 再小 15~20%) + +```nginx +# 需要 ngx_brotli 模块(宝塔/oneinstack 通常自带开关) +brotli on; +brotli_comp_level 5; +brotli_min_length 1024; +brotli_types text/plain text/css application/javascript application/json image/svg+xml; +``` + +若不想装模块,至少开启静态预压缩,减少动态压缩的 CPU 抖动: + +```nginx +gzip_static on; +``` + +### 4.3 HTTP/3 的取舍 + +响应头里有 `Alt-Svc: h3=":443"`。如果 QUIC 监听实际不稳定(部分企业网络封 UDP 443), +**部分浏览器会先尝试 h3 再回退**,表现为首包变慢。建议二选一: + +- 确认 `listen 443 quic reuseport;` 正常、UDP 443 可达 → 保留; +- 不确定 → 去掉 `add_header Alt-Svc ...`,让所有浏览器统一走已验证的 h2。 + +--- + +## 5. Edge 侧排查清单(在慢的那台 PC 上做) + +1. `edge://version`:确认版本与 Chrome 接近(相差太大会有新 API 降级路径)。 +2. `edge://gpu`:确认 **硬件加速已开启**(`Graphics Feature Status` 里 + `Canvas` / `Compositing` 为 `Hardware accelerated`)。被组策略关掉时, + 大表格滚动、阴影、过渡会明显变卡。 +3. 设置 → 系统和性能: + - 关闭「**效率模式**」(Efficiency mode); + - 关闭本站在「**睡眠标签页**」里被挂起的可能(把站点加入「从不休眠」); + - 开启「启动加速」。 +4. 扩展:用「InPrivate 窗口 / 禁用所有扩展」复测一次,排除单个扩展注入脚本。 +5. 网络:`edge://net-internals/#dns` 清 DNS;确认没有走慢速代理; + 关闭「使用安全 DNS」后再测(DoH 解析慢会直接拖慢首包)。 +6. 安全软件:确认 Defender 实时防护 / 第三方安全软件没在逐个扫描每个 `.js` 分片 + (这也是「分片多」会被放大的典型场景)。 +7. 复测方法:两台机器都打开 `https://<站点>/?perf=1`,对比控制台报告里的 + `TTFB`(网络)与 `长任务合计`(CPU)。 + +--- + +## 6. 后续可选(按性价比排序,需单独评估回归) + +| 优化 | 预期收益 | 风险 / 成本 | +|---|---|---| +| Element Plus 样式按需(`importStyle: 'css'`,替代 `element-plus/dist/index.css`) | `index.css` 382KB → 约 100KB 级;样式匹配 / 重算成本明显下降 | 需补 message / message-box / notification / loading / overlay 等命令式样式入口,**必须做全站视觉回归** | +| `build.cssCodeSplit: false`(329 个 CSS 合并为 1 个) | 切页 CSS 请求数 → 0;弱网 + 分片多时收益明显 | 首屏 CSS 体积上升(约 +30KB gzip),需实测首屏是否变慢 | +| 把 Element Plus 用到的组件合并成 1~2 个 `vendor-ep` chunk | 减少重复小请求、提升缓存命中 | 与「按需引入减小体积」需权衡,需实测 chunk 总量 | +| 清理剩余 `transition: all`(约 40 处) | 减少 hover / 插入时的 layout 抖动 | 纯样式,逐处验证动画效果 | +| 首屏骨架 / 预渲染 `index.html` | 首屏感知更快 | 需与品牌化标题逻辑(frontBrand)协调 | + +--- + +## 7. 附:本次改动的文件清单 + +``` +src/router/index.ts glob 改为按需加载 + 推断分支调整 +src/router/view-glob.ts 新增(glob 兜底表独立 chunk) +src/utils/path.ts 新增(替代 path-browserify) +src/utils/perf-probe.ts 新增(?perf=1 性能探针) +src/layout/component/TaskView/index.vue 改用 resolveRoutePath +src/layout/component/Sidebar/SidebarItem.vue 改用 resolveRoutePath +src/layout/component/Navbar.vue 后台标签不轮询 +src/styles/index.scss 移除 text-rendering +src/styles/transition.scss 面包屑过渡收窄属性 +src/main.ts 安装性能探针 +``` diff --git a/src/components/ImagesUpload/index.vue b/src/components/ImagesUpload/index.vue index 75a633e8..e5250826 100644 --- a/src/components/ImagesUpload/index.vue +++ b/src/components/ImagesUpload/index.vue @@ -1,106 +1,113 @@ diff --git a/src/views/stock/stock/component/info.vue b/src/views/stock/stock/component/info.vue index fb9b3801..46d2e1b9 100644 --- a/src/views/stock/stock/component/info.vue +++ b/src/views/stock/stock/component/info.vue @@ -1,9 +1,50 @@