全部学科
NodeJS全栈
nodejs
Python全栈
python
小程序首页
📅 2026-05-23 5 分钟 ✍️ juanwangdev

Chunk 大小警告处理

构建时 chunk 超过阈值会显示警告,可调整阈值或优化分包策略。

默认警告阈值

默认 500KB,超过此值会显示警告:

JavaScript
(!) Some chunks are larger than 500 kB after minification.

调整警告阈值

JavaScript
export default defineConfig({
  build: {
    chunkSizeWarningLimit: 1000  // 调整为 1000KB
  }
})

禁用警告

JavaScript
export default defineConfig({
  build: {
    chunkSizeWarningLimit: Infinity  // 禁用警告
  }
})

注意:不建议禁用警告,大 chunk 影响加载性能。

优化分包解决警告

Bash
export default defineConfig({
  build: {
    rollupOptions: {
      output: {
        manualChunks(id) {
          // 大依赖单独分包
          if (id.includes('node_modules')) {
            if (id.includes('large-lib')) {
              return 'large-lib'
            }
            return 'vendor'
          }
        }
      }
    }
  }
})

分析大 chunk 原因

JavaScript
# 安装分析插件
npm add -D rollup-plugin-visualizer
text
import { visualizer } from 'rollup-plugin-visualizer'

export default defineConfig({
  plugins: [
    visualizer({
      filename: 'stats.html',
      open: true
    })
  ]
})

构建后打开 stats.html 可视化分析 chunk 组成。

警告处理策略

策略操作适用场景
调整阈值chunkSizeWarningLimit合理的大 chunk
优化分包manualChunks可拆分的大 chunk
禁用警告Infinity不推荐

chunk 大小影响因素

  • 第三方依赖体积
  • 业务代码数量
  • 是否使用 Tree Shaking
  • 压缩效果

要点总结

  • 默认阈值 500KB
  • chunkSizeWarningLimit 调整阈值
  • 推荐优化分包而非禁用警告
  • 使用 visualizer 分析 chunk 组成

📝 发现内容有误?点击此处直接编辑

← 上一篇 框架特定的构建优化
下一篇 → Source Map 生成策略
想查看更多题目和详细解析?
小程序提供完整的题库、模拟考试和详细解析
马上就来

长按或扫描二维码,立即体验

扫码体验小程序
马上就来
使用微信扫描二维码
立即体验完整题库