webpack 的 performance 配置用于设置资源体积预算限制,超限时发出警告或报错,是监控机制而非压缩手段;需在 webpack.config.js 中配置 hints、maxassetsize 和 maxentrypointsize,结合 bundle analyzer 定位问题。

Webpack 提供了 performance 配置项,用于设定资源体积的“预算限制”(budget),当打包产物超出预设阈值时,会主动在控制台发出警告或报错。这不是压缩手段,而是监控和约束机制,能帮助团队在开发阶段就发现体积失控风险。
设置 performance 预算限制
在 webpack.config.js 中添加 performance 字段即可:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
module.exports = {
// ...其他配置
performance: {
hints: 'warning', // 或 'error'、false(禁用提示)
maxAssetSize: 250000, // 单个资源文件最大体积,单位字节(如 250KB)
maxEntrypointSize: 500000, // 入口 chunk 总体积上限(含所有依赖),单位字节(如 500KB)
}
};
-
hints: 'warning':超限时仅打印黄色警告(默认行为) -
hints: 'error':超限时构建失败(CI/CD 中推荐,防体积“破防”) -
hints: false:完全关闭提示(不建议)
✅ 示例:若某个
.js文件打包后达 300KB,而maxAssetSize设为250000,Webpack 就会报 Warning;若设为'error',则npm run build直接中断。
实际应用建议
-
按环境区分策略:开发时用
warning,生产构建用'error',避免上线前遗漏大包 -
结合 Bundle Analyzer 定位问题:警告只告诉你“超了”,但不告诉“谁超了”——需配合
webpack-bundle-analyzer查看具体模块体积 -
合理设置阈值:
- 移动端首屏 JS 建议 ≤ 170KB(gzip 后),对应未压缩体积约 500KB
- 可设
maxEntrypointSize: 500000,再通过splitChunks拆分 vendor 和业务代码,使入口更轻
注意事项
-
performance不影响实际打包结果,只起提醒作用 - 它对
.css、.jpg、.svg等所有assets生效(只要 Webpack 管理的输出资源) - 若使用
html-webpack-plugin注入 script,入口体积包含其依赖的全部 chunk(包括异步加载的,除非显式排除)
不复杂但容易忽略
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










