利用PHPStudy（Mac版）部署Nuxt3项目 （node-server模式从零开始部署指南）

一、准备工作：安装PHPStudy（Mac版）与Nuxt3项目

首先，前往PHPStudy官网下载PHPStudy Mac版，并完成安装。同时确保你的Mac已安装Node.js（建议v18+）和npm/yarn。如果你还没有Nuxt3项目，可以使用以下命令快速创建：npx nuxi@latest init my-nuxt-app。这个环节是本地开发环境搭建的基础，请务必完成。

二、构建Nuxt3项目（node-server模式）

进入项目目录，安装依赖并构建：npm install && npm run build。构建完成后，项目根目录下会生成.output文件夹，其中server目录包含Node服务端代码，public目录为静态资源。这就是我们即将部署的node-server模式配置的核心产物。

三、在PHPStudy中创建网站并配置反向代理

打开PHPStudy面板，点击「网站」-「新增网站」，填写域名（如nuxt.local）并设置根目录为.output/public。由于Nuxt3部署指南中推荐将API和SSR请求转发至Node服务，我们需要配置Nginx反向代理。在PHPStudy中，点击对应网站的「管理」-「修改配置」，将以下代码插入到location /中：

proxy_pass http://127.0.0.1:3000;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

四、启动Nuxt3 Node服务

在终端中进入项目根目录，执行node .output/server/index.mjs，此时Node服务将运行在3000端口（默认）。为确保服务常驻，可以使用pm2或forever管理进程。这一步是node-server模式配置的关键，务必保持终端窗口不关闭。

五、测试访问与常见问题

打开浏览器，访问你在PHPStudy中设置的域名（或本机IP）。如果能正常看到Nuxt3页面，并且API接口能返回数据，说明部署成功！常见问题包括端口冲突、Nginx配置错误等，请检查防火墙和端口占用。本PHPStudy Mac版教程旨在帮助你避开这些坑，快速上线项目。

六、总结

通过以上步骤，我们成功利用PHPStudy Mac版部署了Nuxt3的node-server模式项目。整个过程涵盖了本地开发环境搭建、构建、反向代理配置等核心知识。希望这篇Nuxt3部署指南能成为你项目上线的得力助手。如有疑问，欢迎在评论区留言讨论！