You need to enable JavaScript to run this app. 如何在Next.js应用中移除构建后生成的未使用.js chunks
优惠活动
大模型
产品
解决方案
定价
更多

如何在Next.js应用中移除构建后生成的未使用.js chunks

Next.js未使用JS chunks优化方案

这些未被使用的chunks是Next.js基于webpack/Turbopack的代码分割规则自动生成的产物,通常为跨路由共享的公共依赖包、全局公共组件、或未被当前页面调用的动态导入组件代码。你可以按照以下步骤逐步排查优化:

  • 定位chunk对应内容
    先安装@next/bundle-analyzer构建分析工具,在next.config.js中添加如下配置:
    const withBundleAnalyzer = require('@next/bundle-analyzer')({
      enabled: process.env.ANALYZE === 'true'
    })
    
    module.exports = withBundleAnalyzer({
      // 其余原有配置保持不变
    })
    
    运行ANALYZE=true npm run build启动构建,构建完成后会自动打开分析页面,可直观看到每个chunk包含的所有依赖、组件代码,确认未使用的代码来源。
  • 优化第三方依赖引入
    如果分析后发现是全量引入的大型第三方库导致的冗余,改为按需引入:比如lodash仅导入用到的方法import debounce from 'lodash/debounce',不要全量导入import _ from 'lodash';大型UI组件库也开启按需引入配置。
    确认无副作用的依赖可以在package.json中添加"sideEffects": false声明,帮助构建工具完成摇树,删除未被调用的代码。
  • 调整动态导入规则
    如果是仅客户端运行的动态导入组件,添加ssr: false配置避免服务端构建时额外打包冗余代码:
    const DynamicComponent = dynamic(() => import('../components/xxx'), {
      ssr: false,
      loading: () => <p>加载中</p>
    })
    
    同时检查是否存在写在当前页面但实际未渲染的动态导入组件,直接删除即可。
  • 自定义chunk拆分策略
    如果是公共chunk提取规则不合理导致无关代码被打包到当前页面,可以在next.config.js中自定义webpack拆包规则:
    module.exports = {
      webpack: (config, { isServer }) => {
        if (!isServer) {
          // 调整为被3个及以上路由引用的依赖才会被提取为公共chunk
          config.optimization.splitChunks.cacheGroups.commons.minChunks = 3
        }
        return config
      }
    }
    
  • App Router模式额外检查
    如果你使用的是Next.js 13+的App Router,确认服务端组件和客户端组件的划分是否正确,不要把仅服务端运行的逻辑放在客户端组件中,避免非必要代码被打包到客户端chunk。

内容的提问来源于stack exchange,提问作者ninsau

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 14:36:04