gil
5f664546cf
- CLAUDE.md 운영 규칙 - wiki/ 정리된 지식 페이지 (Nuxt + Claude Code) - raw/ 원본 자료 - reference/ Nuxt 4.x 공식 문서 Co-authored-by: Cursor <cursoragent@cursor.com>
49 lines
3.0 KiB
Markdown
49 lines
3.0 KiB
Markdown
---
|
|
title: "nuxt build"
|
|
description: "Build your Nuxt application."
|
|
links:
|
|
- label: Source
|
|
icon: i-simple-icons-github
|
|
to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/build.ts
|
|
size: xs
|
|
---
|
|
|
|
<!--build-cmd-->
|
|
```bash [Terminal]
|
|
npx nuxt build [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--prerender] [--preset] [--dotenv] [--envName] [-e, --extends=<layer-name>] [--profile[=verbose]]
|
|
```
|
|
<!--/build-cmd-->
|
|
|
|
The `build` command creates a `.output` directory with all your application, server and dependencies ready for production.
|
|
|
|
## Arguments
|
|
|
|
<!--build-args-->
|
|
| Argument | Description |
|
|
|---------------|------------------------------------------------|
|
|
| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
|
|
<!--/build-args-->
|
|
|
|
## Options
|
|
|
|
<!--build-opts-->
|
|
| Option | Default | Description |
|
|
|--------------------------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
|
|
| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
|
|
| `--prerender` | | Build Nuxt and prerender static routes |
|
|
| `--preset=<preset>` | | Specify Nitro server preset. Available presets depend on Nitro (e.g. `node-server`, `vercel`, `netlify`, `static`) |
|
|
| `--dotenv` | | Path to `.env` file to load, relative to the root directory |
|
|
| `--envName` | | The environment to use when resolving configuration overrides (default is `production` when building, and `development` when running the dev server) |
|
|
| `-e, --extends=<layer-name>` | | Extend from a Nuxt layer |
|
|
| `--profile` | | Profile performance (v4.4+). Writes a V8 CPU profile and JSON report on exit. Use `--profile=verbose` for a full console report. |
|
|
<!--/build-opts-->
|
|
|
|
::note
|
|
This command sets `process.env.NODE_ENV` to `production`.
|
|
::
|
|
|
|
::note
|
|
`--prerender` will always set the `preset` to `static`
|
|
::
|