如何在 Next.js 中使用自定义 webpack 版本
使用你的应用程序自行安装的 webpack,而不是 Next.js 捆绑的版本。
默认情况下,--webpack 使用随 Next.js 一同捆绑的 webpack 版本。要改用应用程序中安装的 webpack,请在应用程序中安装 webpack,并将 --custom-webpack 传递给 next dev 或 next build。请分别运行开发命令和生产命令;next dev 会一直运行直到被停止:
pnpm add -D webpack@^5.98.0
pnpm next dev --custom-webpack
pnpm next build --custom-webpacknpm install -D webpack@^5.98.0
npx next dev --custom-webpack
npx next build --custom-webpackyarn add -D webpack@^5.98.0
yarn next dev --custom-webpack
yarn next build --custom-webpackbun 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 里:
hoistPattern:
- '*eslint*' # 已有的示例模式;保留你自己的模式。
- webpack保留你项目已在使用的任何其他模式。如果你使用 pnpm 默认的 hoistPattern(['*']),则无需此设置。如果你已通过 hoist: false 完全禁用了提升,请在使用 hoistPattern 之前先启用它。有关详情,请参阅 pnpm 的 node-modules 设置。