パッケージバンドリングの最適化方法

外部パッケージのバンドリングはアプリケーションのパフォーマンスを大幅に向上させることができます。デフォルトでは、サーバーコンポーネントやルートハンドラー内でインポートされたパッケージはNext.jsによって自動的にバンドルされます。このページでは、パッケージバンドリングを分析しさらに最適化する方法を解説します。

JavaScriptバンドルの分析

@next/bundle-analyzerはNext.jsのプラグインで、アプリケーションのバンドルサイズを管理するのに役立ちます。各パッケージとその依存関係のサイズを視覚的なレポートとして生成します。この情報を使用して大きな依存関係を削除したり、コードを分割したり、遅延読み込みしたりできます。

インストール

以下のコマンドを実行してプラグインをインストールします：

npm i @next/bundle-analyzer
# または
yarn add @next/bundle-analyzer
# または
pnpm add @next/bundle-analyzer

次に、バンドルアナライザーの設定を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
# または
ANALYZE=true yarn build
# または
ANALYZE=true pnpm build

レポートはブラウザで3つの新しいタブとして開かれ、調査できます。定期的にアプリケーションのバンドルを評価することで、アプリケーションのパフォーマンスを維持するのに役立ちます。

パッケージインポートの最適化

アイコンライブラリなどの一部のパッケージは数百のモジュールをエクスポートする可能性があり、開発環境や本番環境でパフォーマンスの問題を引き起こす可能性があります。

これらのパッケージのインポート方法を最適化するには、next.config.jsにoptimizePackageImportsオプションを追加します。このオプションは、実際に使用するモジュールのみをロードしつつ、多くの名前付きエクスポートを含むインポート文を書く便利さを維持します。

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

module.exports = nextConfig

Next.jsはまた、いくつかのライブラリを自動的に最適化するため、それらはoptimizePackageImportsリストに含める必要はありません。完全なリストを参照してください。

特定パッケージのバンドリング除外

サーバーコンポーネントやルートハンドラー内でインポートされたパッケージはNext.jsによって自動的にバンドルされるため、next.config.jsでserverExternalPackagesオプションを使用して特定のパッケージをバンドリングから除外できます。

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

module.exports = nextConfig

Next.jsには現在互換性作業中の人気パッケージのリストが含まれており、これらは自動的に除外されます。完全なリストを参照してください。