NNext.js 中文网 GitHub

如何在 Next.js 中使用自定义 webpack 版本

使用应用程序中安装的 webpack 而非捆绑版本来配合 Next.js。

默认情况下,--webpack 使用随 Next.js 一同捆绑的 webpack 版本。要改用应用程序中安装的 webpack,请在应用程序中安装 webpack,并将 --custom-webpack 传递给 next dev 或 next build。请分别运行开发命令和生产命令;next dev 会一直运行直到被停止:

bash · pnpm
pnpm add -D webpack@^5.98.0
pnpm next dev --custom-webpack
pnpm next build --custom-webpack
bash · npm
npm install -D webpack@^5.98.0
npx next dev --custom-webpack
npx next build --custom-webpack
bash · yarn
yarn add -D webpack@^5.98.0
yarn next dev --custom-webpack
yarn next build --custom-webpack
bash · bun
bun add -D webpack@^5.98.0
bunx next dev --custom-webpack
bunx next build --custom-webpack

使用自定义 webpack 版本需自行承担风险。 Next.js 不会验证已安装的 webpack 版本,也不保证与其他版本的兼容性。示例使用 ^5.98.0;此功能已在 webpack 5.98.0 和 5.111.0 上测试。

请在应用程序目录中运行安装命令。当 Next.js 计算 next.config.js 时,自定义版本就已可用,因此你的 webpack 配置和插件可以导入它。如果应用程序中未安装 webpack,--custom-webpack 会提示如何安装它。

在受限提升(hoisting)下使用 pnpm: 即使 pnpm 不提升 webpack,Next.js 也会直接从你的应用程序中解析它。但是,自定义 webpack 插件或其他工作区工具可能会从它们自己的包位置解析 webpack。如果因为你限制了 pnpm 的提升而无法找到它,请将 webpack 添加到工作区根目录 pnpm-workspace.yaml 中已有的 hoistPattern 里:

pnpm-workspace.yaml
hoistPattern:
  - '*eslint*' # 已有的示例模式;保留你自己的模式。
  - webpack

保留你项目已在使用的任何其他模式。如果你使用 pnpm 默认的 hoistPattern(['*']),则无需此设置。如果你已通过 hoist: false 完全禁用了提升,请在使用 hoistPattern 之前先启用它。有关详情,请参阅 pnpm 的 node-modules 设置。