Next.js - CLI build 命令
在 Next.js CLI 中,`build` 命令用于创建 Next.js 应用程序的生产就绪版本。此命令提供各种选项来自定义构建过程和环境。在本章中,我们将解释如何使用 `build` 命令创建可自定义的 Next.js 生产版本。
Next.js 构建命令语法
以下是 Next.js CLI 中构建命令的语法。
npx next build [options]
例如,npx next build --no-lint。在这里,生产构建将在当前目录中进行,并且禁用 linting。
构建命令的选项
以下是 `build` 命令可用的选项列表。
选项 | 说明 |
---|---|
-h, --help | 显示所有可用选项。 |
[directory] | 指定用于构建应用程序的目录。如果未提供,则使用当前目录。 |
-d 或 --debug | 启用更详细的构建输出。包括其他构建详细信息,如重写、重定向和标头。 |
--profile | 为 React 启用生产分析。 |
--no-lint | 在构建过程中禁用 linting(错误建议)。 |
--no-mangling | 禁用 mangling,这可能会影响性能,旨在用于调试目的。 |
--experimental-app-only | 仅构建 App Router 路由。 |
--experimental-build-mode [mode] | 使用实验性的构建模式。选项包括"编译"、"生成"或默认的"默认"。 |
指定构建应用程序的目录
如果您当前的终端目录不包含 Next.js 项目,则可以使用带有目录选项的 `build` 命令在其他目录中构建应用程序。如果您未指定任何目录,则默认使用当前目录来构建应用程序。以下是指定目录的语法。
npx next build ./next-js-example
在终端中运行上述命令后,Next.js 构建过程将在 `./next-js-example` 目录中创建可用于生产的应用程序版本。
输出
在输出中,应用程序构建发生在指定的目录中。
避免在构建应用时进行 linting
在 Next.js 构建过程中,linting 是指自动检查代码中是否存在潜在问题,例如错误、样式违规或可能导致错误的模式。您可以使用以下命令避免 linting。
npx next build ./next-js-example --no-lint
输出
在输出中,您可以看到禁用 linting 的 `./next-js-example` 目录的构建过程。