Sponsor
ntab.devntab.dev 提升效率的新标签页组件
点击查看
Menu

Optimizing Package Bundling

打包外部包可以显著提高应用程序的性能。默认情况下,在服务器组件和路由处理程序中导入的包会被 Next.js 自动打包。本页将指导你如何分析并进一步优化包的打包。

分析 JavaScript 打包

@next/bundle-analyzer 是一个 Next.js 插件,可以帮助你管理应用程序打包的大小。它会生成一个可视化报告,显示每个包及其依赖项的大小。你可以使用这些信息来移除大型依赖项、拆分或懒加载你的代码。

安装

通过运行以下命令安装插件:

npm i @next/bundle-analyzer
# or
yarn add @next/bundle-analyzer
# or
pnpm add @next/bundle-analyzer

然后,将打包分析器的设置添加到你的 next.config.js 中。

next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {}
 
const withBundleAnalyzer = require('@next/bundle-analyzer')({
  enabled: process.env.ANALYZE === 'true',
})
 
module.exports = withBundleAnalyzer(nextConfig)

生成报告

运行以下命令来分析你的打包:

ANALYZE=true npm run build
# or
ANALYZE=true yarn build
# or
ANALYZE=true pnpm build

报告将在你的浏览器中打开三个新标签页,你可以进行检查。定期评估应用程序的打包可以帮助你随着时间的推移保持应用程序性能。

优化包导入

一些包,如图标库,可能会导出数百个模块,这可能会在开发和生产环境中导致性能问题。

你可以通过在 next.config.js 中添加 optimizePackageImports 选项来优化这些包的导入方式。这个选项只会加载你实际使用的模块,同时仍然让你能够方便地编写带有多个命名导出的导入语句。

next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    optimizePackageImports: ['icon-library'],
  },
}
 
module.exports = nextConfig

Next.js 还会自动优化一些库,因此它们不需要包含在 optimizePackageImports 列表中。查看完整列表

将特定包排除在打包之外

由于在服务器组件和路由处理程序中导入的包会被 Next.js 自动打包,你可以使用 next.config.js 中的 serverExternalPackages 选项将特定包排除在打包之外。

next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  serverExternalPackages: ['package-name'],
}
 
module.exports = nextConfig

Next.js 包含了一份目前正在进行兼容性开发并自动排除在外的流行包列表。查看完整列表