第23章 GitHub

GitHub

将 GitHub 仓库连接到 v0，通过分支、预览、拉取请求和 CI 来发布变更。

连接 v0 项目到 GitHub，将代码保存在仓库中，在独立分支上工作，预览变更，运行 CI，并通过拉取请求发布。

GitHub 同步在 v0 和 GitHub 之间移动代码。它不会授予通过 GitHub 或其他 Vercel 界面部署的权限。v0 网页应用中的操作使用你的 v0 角色，而由 GitHub 触发的部署和 Vercel CLI 使用你的 Vercel 角色和项目权限。

Vercel Viewer 可以使用 v0 Builder 角色从 v0 发布，但无法通过 GitHub 或 Vercel CLI 部署。

Plus 计划：默认情况下，团队成员必须拥有 GitHub 仓库的访问权限才能协作相关的聊天并生成预览。若要允许未在 Vercel 账户中连接 GitHub 的成员参与，请在你的工作区设置中启用“允许 v0 代表成员操作”。详见 Teams → GitHub 仓库访问权限。

v0 如何与 Git 协同工作

当聊天连接到 GitHub 时，它从你选定的基础分支开始。当 v0 有代码变更需要推送时，它会基于该基础分支创建一个工作分支。生成的代码变更随后会自动提交并推送到工作分支。

分支 | v0 如何使用 ---|--- 默认分支 | GitHub 仓库的默认分支。除非你选择其他分支，否则 v0 在导入仓库时初始选择此分支。 基础分支 | 聊天启动的分支，也是其拉取请求的目标分支。 工作分支 | v0 为聊天创建的分支。v0 将生成的变更推送到这里，而不是直接推送到基础分支。 生产分支 | 在关联的 Vercel 项目中配置的用于创建生产部署的分支。它通常是默认分支或基础分支，而其他分支则创建预览部署。

成功发布后，v0 将聊天返回到更新后的基础分支。下一次代码变更将创建新的工作分支，因此你可以在同一个聊天中继续并发布再次。

连接项目到 GitHub

一旦 GitHub 仓库被连接，它成为项目代码的单一事实来源。如果你删除仓库，代码可能无法恢复。

要连接现有的 v0 项目：

1. 打开项目菜单 … → 设置 → GitHub。 2. 选择“连接”。 3. 在 Git 作用域下，选择将拥有该仓库的 GitHub 账户或组织。 4. 输入仓库名称。 5. 选择“创建仓库”。v0 创建一个私有仓库并将项目的当前代码推送到其中。

之后可以从项目菜单 … → 设置 → GitHub 管理或修复连接。

导入现有仓库

如果要基于已在 GitHub 上的代码开始工作，请使用“从 GitHub 导入”。导入会在选定的基础分支上创建一个聊天；第一次代码变更会创建工作分支。它不会复制一个你可以写入的仓库。你可以将导入连接到现有的 Vercel 项目或创建新项目。

从分支菜单操作

基于 GitHub 的聊天会在聊天标题的“发布”旁边显示当前分支。在第一次代码变更之前和发布之后，这是基础分支。v0 在有代码变更需要推送时惰性创建工作分支。分支菜单将 Git 工作流集中在一处：

* 预览部署：检查工作分支的最新部署并打开其 URL。 * 分支和差异：在 GitHub 上打开分支并查看其增删内容。 * 拉取请求：创建拉取请求或打开现有的拉取请求。 * CI 检查：查看检查是正在运行、通过、跳过还是失败。 * 拉取变更：将基础分支的变更引入工作分支。 * 审查或修复：要求 v0 审查分支、修复失败的预览构建或 CI 检查，或解决合并冲突。该操作会根据当前分支状态变化。

*审查 GitHub 分支预览并将其发布到生产环境。*

每个工作分支都有自己独立的 Vercel 预览部署。使用它可以在不改变项目生产 URL 的情况下审查应用。

发布 GitHub 变更

准备好发布时：

1. 从分支菜单审查分支预览和 CI 状态。 2. 选择“发布”。 3. 在提示时确认域名和部署可见性。 4. 选择“发布”完成。

如果分支没有拉取请求，v0 会创建一个；否则，它重用现有的拉取请求。然后它将拉取请求合并到基础分支，并等待生产部署。

分支保护和被阻止的发布

v0 遵循仓库的 GitHub 规则。必需的检查、必需的审查、草稿拉取请求和其他分支保护可能会阻止合并。当这种情况发生时，v0 保持拉取请求打开，说明需要关注的内容，并链接到 GitHub 上的拉取请求。完成要求后，再次选择“发布”。

如果拉取请求有合并冲突或 v0 可以处理的 CI 失败，请打开分支菜单并选择“修复冲突”、“修复 CI”或“修复 CI + 冲突”。

发布后继续

你不需要在每次发布后创建新聊天。拉取请求合并后，v0 将聊天与基础分支同步。继续在同一聊天中提示；下一次代码变更创建下一个工作分支和预览。

当你想要独立的工作流时创建另一个聊天。每个聊天从其选定的基础分支开始，为其第一次代码变更创建隔离的工作分支，同时共享同一个 GitHub 仓库和 Vercel 项目。

复制分支

要在单独的聊天中继续当前工作：

1. 打开聊天菜单并选择“复制…”。 2. 输入新分支的名称。 3. 选择“分支”。

“复制分支”对话框创建包含当前分支提交的新聊天和分支。副本保持连接到同一个 GitHub 仓库和 Vercel 项目，并针对同一个基础分支拉取请求。

故障排除

“从 GitHub 导入”中缺少仓库

确保 Vercel GitHub App 已安装到正确的 GitHub 账户或组织，并且可以访问该仓库。你可以在 GitHub App 设置中更改仓库访问权限。

分支没有预览

v0 将代码变更推送到工作分支后会出现预览。如果分支菜单显示“无活动预览”，请在聊天中进行代码变更并等待推送和部署完成。

“拉取变更”不可用

当基础分支有聊天中没有的提交时，“拉取变更”可用。如果拉取请求有冲突，请先使用“修复冲突”解决。

发布被阻止

此消息指的是 v0 网页应用中的发布流程。打开拉取请求并审查其必需的检查、审查和分支规则。你可以要求 v0 修复可操作的 CI 或合并冲突失败，但必需的人工审查必须在 GitHub 中完成。

如果 Vercel 阻止了直接从 GitHub 触发的部署，请检查成员的 Vercel 角色和项目权限。v0 角色不授予 v0 网页应用之外的部署权限，Vercel Viewer 无法通过 GitHub 部署。

后续步骤

* 导入现有 GitHub 仓库 * 了解预览和生产部署如何工作 * 管理关联的 Vercel 项目

上一篇：Vercel Connect | 下一篇：MCP 集成