Nuxt 3 reached end of life on 31 July 2026
It no longer receives bug fixes or security patches. Upgrade to Nuxt 4 or get extended support from HeroDevs

nuxt preview

源代码
preview 命令会在 build 命令执行后启动服务器,以预览你的应用
Terminal
npx nuxt preview [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--envName] [-e, --extends=<layer-name>] [-p, --port] [--dotenv]

preview 命令会在运行 build 命令后启动服务器,以预览你的 Nuxt 应用。start 命令是 preview 的别名。在生产环境中运行应用时,请参阅部署部分

参数

参数描述
ROOTDIR="."指定工作目录(默认值:.

选项

选项默认值描述
--cwd=<directory>指定工作目录,其优先级高于 ROOTDIR(默认值:.
--logLevel=<silent|info|verbose>指定构建时日志级别
--envName解析配置覆盖项时使用的环境(构建时默认为 production,运行开发服务器时默认为 development
-e, --extends=<layer-name>从 Nuxt layer 扩展
-p, --port要监听的端口
--dotenv要加载的 .env 文件路径,相对于根目录

如果未提供 --port,则按顺序使用 NUXT_PORTNITRO_PORTPORT 环境变量。

此命令会将 process.env.NODE_ENV 设置为 production。若要覆盖此设置,请在 .env 文件中或作为命令行参数定义 NODE_ENV

为方便起见,在预览模式下,你的.env 文件会被加载到 process.env 中。(但是,在生产环境中,你需要自行确保环境变量已设置。例如,使用 Node.js 20+ 时,可以运行 NODE_ENV=production node --env-file .env .output/server/index.mjs 来启动服务器。)