如何在NODE_ENV=production环境下运行Nuxt3应用？部署疑问

为什么Nuxt默认被列为devDependency？ #

Nuxt是构建/开发工具，核心作用是帮你打包、生成静态资源或构建服务端渲染产物。生产环境只需要最终的输出结果（比如.output/public里的静态文件），不需要Nuxt核心包本身运行。默认将其放在devDependencies是合理的，能减少生产环境依赖体积，避免不必要的资源占用。

解决nuxt: command not found报错的正确流程 #

你遇到的报错根源是：Nuxt3在yarn install后会自动执行nuxt prepare（构建前的准备操作），但生产模式下仅安装生产依赖，找不到devDependencies里的nuxt命令。针对不同场景，有两种解决方案：

方案一：本地/CI完成构建，仅部署静态产物（推荐） #

这是最标准的静态站点部署流程，完全避免服务器上的依赖问题：

• 本地或CI环境操作：
  1. 安装所有依赖（包括dev）：yarn install
  2. 加载生产环境变量并生成静态资源：NODE_ENV=production yarn nuxt generate
  3. 将生成的.output/public目录下的所有文件，上传到服务器的静态服务（如Nginx、CDN）
• 服务器端无需安装任何Nuxt相关依赖，只需要托管静态文件即可。

方案二：必须在服务器上构建时的处理 #

如果因为业务需求需要在服务器上执行构建（比如动态生成内容），可以这么做：

1. 先安装所有依赖（不要加--production参数）：yarn install
2. 加载生产环境变量执行生成：NODE_ENV=production yarn nuxt generate
3. （可选）生成完成后，清理dev依赖减少体积：yarn install --production
4. （可选）修改package.json的prepare脚本，避免生产环境自动执行：

   "scripts": {
     "prepare": "NODE_ENV=development nuxt prepare"
   }
   

   注意：修改后需要确保构建前手动执行nuxt prepare。

不推荐将Nuxt移到dependencies的原因 #

把nuxt从devDependencies移到dependencies确实能解决报错，但完全没必要——生产环境根本不需要运行Nuxt命令，只会增加依赖包体积，还可能引入不必要的安全风险。只有当你需要在生产环境运行nuxt start（比如服务端渲染SSR模式）时，才需要将Nuxt列为常规依赖。

内容的提问来源于stack exchange，提问作者lando