必须在构建时将实际打包体积注入HTML模板,而非运行时估算;Webpack用HtmlWebpackPlugin的templateParameters传入stats.assets大小,Vite用vite-plugin-html注入,SSR框架则在生成阶段将体积作为props或全局变量注入。

HTML里怎么加“约2.3MB”这类导出体积提示
直接写死文本不行——用户看到的体积必须随实际打包结果动态变化,否则会误导。关键不是“怎么显示”,而是“怎么把构建时算出的体积传进HTML”。常见做法是构建工具注入,而非手写或JS运行时估算。
- Webpack 用户:用
HtmlWebpackPlugin的templateParameters把stats里的资源大小塞进去,模板里写<span>约</span><span>MB</span> - Vite 用户:改用
vite-plugin-html,在inject配置里传入{ fileSizeMB: (buildInfo?.assets?.[0]?.size || 0) / 1024 / 1024 },模板中同样用插值 - 别用 JS 运行时读
document.currentScript.src或发请求查自身体积——这既不准(压缩/CDN/Gzip 后差异大),又慢(多一次网络请求),还可能跨域失败
为什么不能靠 document.body.innerHTML 或 fetch('./index.html') 估算
HTML 文件本身体积 ≠ 实际加载体积。浏览器加载的是经服务器处理后的响应体:可能被 Gzip/Brotli 压缩、被 CDN 缓存重写、被 Service Worker 拦截并注入代码。更糟的是,fetch('./index.html') 返回的是 HTML 字符串长度,单位是字节,不是原始文件大小,且不含 CSS/JS 等外链资源。
-
fetch('./index.html').then(r => r.text()).then(t => t.length)得到的是解压后 UTF-8 字节数,和磁盘上index.html文件大小不一致 - 如果用了
CompressionPlugin或 Nginx 的gzip on,真实传输体积可能只有原始的 1/3,但 JS 无法得知服务端是否启用压缩 - 构建阶段知道确切产物尺寸;运行时只知道“当前页面渲染结果”,二者根本不在同一抽象层
HtmlWebpackPlugin 注入体积时容易漏掉的三个细节
很多人配了 templateParameters 却发现变量没生效,问题通常不在逻辑,而在构建流程时机或配置粒度。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 确保 Webpack 的
stats配置包含assets字段:stats: { assets: true },否则compilation.getStats().toJson()里没有文件大小数据 -
HtmlWebpackPlugin的filename必须匹配你最终部署的入口 HTML 路径,否则注入逻辑不会触发(比如配成'dist/app.html',但实际访问的是/index.html) - 体积单位要统一:Webpack
stats.assets给的是字节数,除以1024 * 1024得 MB,但建议保留一位小数:Math.round(size / 1024 / 1024 * 10) / 10,避免出现 “约2.3499999999999996MB”
SSR 或静态站点生成器(如 Next.js、Nuxt)怎么处理
这类框架不走 Webpack 直接注入 HTML 模板的路子,得在生成阶段把体积信息作为页面 props 或全局变量带进去。本质仍是构建时计算,只是注入位置变了。
立即学习“前端免费学习笔记(深入)”;
- Next.js:在
getStaticProps里读取.next/server/pages/index.js文件大小(注意路径随输出目录变化),然后传给页面组件渲染提示 - Nuxt 3:用
nitro.hooks在prerender:generatePage阶段获取产出 HTML 路径,调fs.statSync取 size,再写入__NUXT__全局对象 - 所有 SSR 场景下,千万别在
useEffect或onMounted里异步 fetch 自身 HTML——服务端渲染时这段 JS 不执行,首屏就空着,SEO 和用户体验双崩
真正难的不是算数字,是让这个数字在正确的时间、以正确的单位、通过正确的管道,出现在用户打开页面那一刻的 DOM 里。构建流程一旦变复杂(比如多页、多语言、分包),体积来源就得对应到具体 chunk,而不是笼统地写“整个应用约2.3MB”。


















