vercel 是 cursor 项目最契合的公网部署平台，需规范项目结构、显式配置 vercel.json、本地验证清理、启用关键构建选项，并利用 cursor composer 同步更新部署配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 Cursor 中的 AI 辅助开发，并希望将项目稳定、高效地部署至公网，Vercel 是当前最契合 Cursor 工作流的托管平台。以下是实现高可靠性部署的关键实践路径：
一、构建符合 Vercel 检测规范的项目结构
Vercel 依赖明确的项目信号（如框架声明、入口文件、构建脚本）自动识别并执行构建流程。Cursor 生成的代码若未按约定组织，将导致构建失败或路由异常。
1、确保项目根目录存在 package.json，且其中包含标准框架脚本，例如 Next.js 项目需有 "dev": "next dev", "build": "next build", "start": "next start"。
2、创建 pages/_app.js（或 app/layout.tsx，视 Next.js 版本而定）作为应用根组件，避免缺失布局导致白屏。
3、所有 API 路由必须置于 pages/api/ 目录下（或 app/api/），否则 Vercel 默认不启用 Node.js 运行时。
二、显式声明 vercel.json 构建与路由规则
默认行为无法覆盖 Cursor 中常见的非标配置，例如本地 LLM 代理层、自定义中间件或混合静态/动态路由。vercel.json 提供精准控制权，防止环境差异引发线上异常。
1、在项目根目录新建 vercel.json 文件。
2、写入版本 2 配置，强制指定构建器与源文件映射：{"version": 2, "builds": [{"src": "pages/api/**", "use": "@vercel/node"}, {"src": "next.config.js", "use": "@vercel/next-js"}], "routes": [{"src": "/api/(.*)", "dest": "/pages/api/$1"}]}。
3、若项目含 .env.local 中的敏感变量，须在 Vercel Dashboard 的 Environment Variables 中**手动添加同名变量**，不可提交该文件。
三、Git 提交前完成本地验证与清理
Cursor 的 AI 生成逻辑可能引入未声明依赖、调试用 console 或临时占位文件，这些内容若进入 Git 提交历史，将污染生产构建上下文，增加失败风险。
1、在 Cursor 内置终端运行 npm run build，确认本地可成功生成 .next/ 输出目录。
2、检查 .gitignore 是否已排除 node_modules/、.next/、.vercel/ 及所有 .env* 文件。
3、执行 git status --ignored，确认无意外未跟踪文件；若有，使用 git clean -fd 清理工作区。
四、Vercel Dashboard 中启用关键构建选项
Vercel 的 UI 设置项直接影响部署结果的稳定性与安全性，部分选项在导入仓库时默认关闭，必须主动开启。
1、进入 Project Settings → Build & Development Settings，将 Build Command 显式设为 npm run build（禁用自动检测）。
2、将 Output Directory 设为 .next（Next.js）或 dist（Vite/Vue），避免 Vercel 错误扫描根目录。
3、在 Git Integration 区域，勾选 Auto-instantiate Preview Deployments for Pull Requests，确保每次 PR 均触发隔离预览环境。
五、利用 Cursor Composer 模式同步更新部署配置
当线上行为与本地不符时，传统方式需手动修改 vercel.json 或 Dashboard 设置。Cursor 的 Composer 模式支持直接编辑远程部署配置文件，并实时生成 diff，大幅缩短调试周期。
1、在 Cursor 中打开 vercel.json，输入提示：“为 Next.js App 添加重定向规则，将 /blog/* 永久跳转至 /posts/$1”。
2、Composer 生成完整 JSON 补丁后，点击 Apply，文件自动更新并高亮变更行。
3、提交该变更至 GitHub，Vercel 将在下次推送后自动拉取新配置并重建部署。
