进阶 v0.dev 2026-11-12 04:30:30 · 20 阅读

第24章 v0 与 GitHub 集成

GitHub 将 v0 项目连接到 GitHub,以便在代码仓库中管理代码、在隔离分支上开发、预览更改、运行 CI 以及通过 Pull Request 发布。 GitHub 同步在 v0 和 GitHub 之间同步代码。它不会授予通过 GitHub 或其他 Vercel 接口部署的权限。v0 Web 应用中的操作使用你的 v0 角色,而由 GitHub 触发的部署和 Vercel CLI 使用你的 Vercel 角色和项目权限。 拥有 Vercel Viewer 角色的用户可以使用 v0 Builder 角色从 v0 发布,但不能通过 GitHub 或 Vercel CLI 进行部署。 Plus 套餐:默认情况下,团队成员必须拥有 GitHub 仓库的访问权限,才能协作相关的聊天并生成预览。允许未连接 GitHub 的 Vercel 账户成员参与协作,请在 workspace 设置中启用 "Allow v0 to Act on Behalf of Members"。详情见 Teams → GitHub repository access。 v0 如何与 Git 协作 当聊天连接到 GitHub 时,它会从你选择的基分支(base branch)开始。当 v0 有代码更改需要推送时,它会从该基分支创建一个工作分支(working branch)。生成的代码更改会自动提交并推送到工作分支。 分支 | v0 如何使用 | 默认分支 | GitHub 仓库的默认分支。导入仓库时,v0 初始会选择它,除非你选择了其他分支。 | 基分支 | 聊天起始的分支,也是其 Pull Request 指向的分支。 | 工作分支 | v0 为聊天创建的分支。v0 将生成的更改推送到这里,而不是直接推送到基分支。 | 生产分支 | 在关联的 Vercel 项目中配置的用于创建生产部署的分支。它通常是默认分支或基分支,而其他分支会创建预览部署。

成功发布后,v0 会将聊天返回到更新后的基分支。下一次代码更改将创建新的工作分支,因此你可以在同一聊天中继续操作并再次发布。 连接项目到 GitHub 一旦 GitHub 仓库连接成功,它就会成为项目代码的单一事实来源(source of truth)。如果删除该仓库,代码可能无法恢复。 要连接现有的 v0 项目:

打开项目菜单 ... → 设置 → GitHub。 选择连接(Connect)。 在 Git Scope 下,选择将拥有该仓库的 GitHub 账户或组织。 输入仓库名称。 选择创建仓库(Create Repository)。v0 会创建一个私有仓库,并将项目当前的代码推送至其中。

后续可从项目菜单 ... → 设置 → GitHub 管理或修复连接。 导入现有仓库 如果希望基于 GitHub 上已有的代码开始,请使用“从 GitHub 导入”。导入会在选定的基分支上创建一个聊天;首次代码更改会创建工作分支。这不会复制一个可写仓库。你可以将导入连接到现有的 Vercel 项目,也可以创建一个新项目。 从分支菜单操作 GitHub 支持的聊天会在聊天头部的“发布”按钮旁显示当前分支。在首次代码更改之前和发布之后,显示的是基分支。当有代码更改需要推送时,v0 会延迟创建工作分支。分支菜单将 Git 工作流集中在一处:

预览部署:查看工作分支的最新部署并打开其 URL。 分支和差异:在 GitHub 上打开该分支,查看其新增和删除的内容。 Pull Request:创建或打开现有的 Pull Request。 CI 检查:查看检查项的运行、通过、跳过或失败状态。 拉取更改:将基分支中的更改拉取到工作分支。 审查或修复:请求 v0 审查分支、修复失败的预览构建或 CI 检查,或解决合并冲突。该操作会根据当前分支状态动态调整。

审查 GitHub 分支预览并将其发布到生产环境。 每个工作分支都有独立的 Vercel 预览部署。使用它在不更改项目生产 URL 的情况下,在发布前审查应用。 发布 GitHub 更改 准备就绪时:

从分支菜单审查分支预览和 CI 状态。 选择发布(Publish)。 提示时确认域名和部署可见性。 选择发布以完成。

如果分支没有 Pull Request,v0 会创建一个;否则复用现有的 Pull Request。然后它将 Pull Request 合并到基分支,并等待生产部署完成。 分支保护和阻止发布 v0 遵循仓库的 GitHub 规则。必需的检查、必需的审查、草稿 Pull Request 及其他分支保护可能会阻止合并。当这种情况发生时,v0 会保持 Pull Request 开放状态,解释需要注意的事项,并链接到 GitHub 上的 Pull Request。完成要求后,再次选择发布。 如果 Pull Request 存在 v0 可以解决的合并冲突或 CI 失败,请打开分支菜单,选择“修复冲突”、“修复 CI”或“修复 CI + 冲突”。 发布后继续操作 无需每次发布后都创建新聊天。Pull Request 合并后,v0 会将聊天与基分支同步。可以在同一聊天中继续提示;下一次代码更改将创建下一个工作分支和预览。 当你希望有独立的工作流时,创建另一个聊天。每个聊天从选定的基分支开始,为其首次代码更改创建隔离的工作分支,同时共享相同的 GitHub 仓库和 Vercel 项目。 复制分支 要在单独的聊天中继续当前工作:

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

“复制分支”对话框会创建一个新聊天和分支,包含当前分支的提交。副本保持连接到相同的 GitHub 仓库和 Vercel 项目,并将 Pull Request 指向相同的基分支。 故障排除 “从 GitHub 导入”中缺少仓库 确保已为正确的 GitHub 账户或组织安装 Vercel GitHub App,并且该 App 有权访问该仓库。你可以在 GitHub App 设置中更改仓库访问权限。 分支没有预览 v0 将代码更改推送到工作分支后才会出现预览。如果分支菜单显示“无活动预览”,请在聊天中进行代码更改,等待推送和部署完成。 “拉取更改”不可用 当基分支有聊天中不存在的提交时,“拉取更改”才会启用。如果 Pull Request 存在冲突,请先使用“修复冲突”解决。 发布被阻止 此消息指的是 v0 Web 应用中的发布流程。打开 Pull Request,审查其必需的检查、审查和分支规则。你可以请求 v0 修复可操作的 CI 或合并冲突失败,但必需的人工审查必须在 GitHub 中完成。 如果 Vercel 阻止了直接从 GitHub 触发的部署,请检查成员的 Vercel 角色和项目权限。v0 角色不会授予 v0 Web 应用之外的部署权限,且 Vercel Viewer 无法通过 GitHub 部署。 下一步

导入现有 GitHub 仓库 了解预览和生产部署的工作原理 管理关联的 Vercel 项目 上一节 Vercel 连接 下一节 MCP 集成

评论 (0)