如何在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
相关产品推荐
相关产品推荐

