第27章 Vercel v0 项目部署指南

Deployments

预览并发布 Vercel v0 项目，管理域名、可见性及生产环境更新。

v0 将项目部署到 Vercel。工作分支会生成预览部署供审查，而发布操作则会更新 Vercel 项目的生产部署及稳定的生产环境 URL。

预览与生产部署

预览部署基于工作分支构建。它们拥有独立的 URL，不会改变项目的生产 URL。 生产部署负责提供项目的域名服务。发布操作会将当前工作通过项目配置的 Git 和 Vercel 工作流进行推广。

对于基于 GitHub 的项目，点击“发布”旁边的分支按钮以检查工作分支的预览。该菜单会显示部署状态、分支差异、拉取请求（Pull Request）以及 CI 检查结果。对于未连接 GitHub 的项目，直接点击“发布”即可查看最新部署。

首次发布

点击聊天顶部的“发布”。首次发布流程将引导你完成项目所需的基础设置：

- 创建项目：如果聊天尚未关联 Vercel 项目，请确认 Vercel 项目名称。 - 可见性：选择谁可以访问已部署的应用。可选项取决于团队套餐及部署保护设置。 - 域名：确认提供的 vercel.app 域名，选择已连接的自定义域名，或前往 Vercel 添加新域名。 - 商务模式（如需要）：审查未认领的 Stripe 测试沙箱或 Shopify 开发商店，并选择在发布前是否认领它们。 - 发布：开始生产部署。

每个 Vercel 项目都有一个稳定的生产 URL。未来的生产部署会更新该 URL 上的应用，而不会更改 URL 本身。

更新发布

在完成新的代码修改后：

1. 打开“发布”。 2. 审查生产部署及所选域名。 3. 选择“发布更改”。

对于基于 GitHub 的项目，发布操作会创建或复用拉取请求，将其合并到聊天的基础分支，并等待生产部署完成。GitHub 分支保护规则仍然适用。详见 GitHub → 发布 GitHub 更改。 未连接 GitHub 的项目会直接将聊天中的当前代码部署到连接的 Vercel 项目。

部署状态与操作

部署卡片会实时报告构建进度和最终状态。根据具体部署情况，它还链接到：

- 已部署的网站 - 提交或工作分支 - Vercel 中的部署检查器 - 构建日志和错误

对于基于 GitHub 的项目，分支菜单还会报告 CI 和拉取请求的状态。其 v0 操作会根据当前问题动态变化：审查代码、修复构建、修复 CI、修复冲突，或修复 CI + 冲突。

域名与可见性

你可以从 v0 中更改部署设置：

- 打开项目菜单 ... → 设置 → 域名 以管理项目域名。 - 打开项目菜单 ... → 设置 → Vercel 项目 以管理生产可见性。 - 在首次发布流程中，选择可见性和域名。

高级 DNS 配置、重定向及其他域名设置将在 Vercel 仪表盘中打开。详见 自定义域名。

高级部署设置

打开部署的检查器链接以管理 Vercel 项目，包括：

- 构建和部署设置 - 生产、预览和开发环境的环境变量 - 部署保护和 Vercel 认证 - Web 分析和速度洞察 - 运行时日志和可观测性 - 回滚和重新部署

详见 Vercel 项目配置以了解完整的控制选项。

部署策略

团队可以配置部署策略，限制哪些 Git 来源和部署机制可以创建部署。如果策略阻止了 v0 在目标环境中的发布，团队所有者必须在团队层面允许该来源，或针对该项目覆盖该策略。

故障排除

预览或生产构建失败

当部署出现错误或警告时，选择“通过 v0 修复”或“修复构建”。v0 会读取相关日志，诊断故障并应用修复。在付费计划中，每天在未编辑的代码上有 10 次免费使用次数；之后，修复将像普通提示一样消耗积分。详见 代理功能 → 通过 v0 修复。

如有必要，请 v0 撤销更改或恢复较早的聊天版本，然后再次发布。

GitHub 发布被阻止

打开分支菜单以检查 CI 和拉取请求。v0 可以解决可操作的 CI 失败和合并冲突。但在再次发布之前，必须在 GitHub 中完成所需的审查和其他人工审批规则。

团队禁用了发布

检查团队的部署策略和你的 Vercel 项目权限。发布还需要一个可以编辑聊天并有权部署到连接的 Vercel 项目的 v0 角色。

预期域名缺失

打开项目菜单 ... → 设置 → 域名，确认域名属于连接的 Vercel 项目。未验证的域名必须先在 Vercel 中验证，然后才能选择。

后续步骤

- 连接 GitHub 并通过分支发布 - 添加自定义域名 - 配置环境变量 - 设置 Web 分析

上一篇：Slack 下一篇：自定义域名