WebStorm 2025.2 Help

处理 GitLab 合并请求

使用 GitLab merge requests ,您可以将源分支的更改合并到目标分支。

创建合并请求

  1. 在主菜单中,转到 Git|GitLab|查看合并请求

  2. 在打开的 合并请求 工具窗口中,单击右上角的 加号创建合并请求

    会打开一个新选项卡,其中包含合并请求草稿。

    带有新合并请求的合并请求工具窗口
  3. 单击左侧的 base 代码库名称,并指定将接收更新的分支。

    基础代码库
  4. 单击右侧的 head 代码库名称,并指定将合并到 base 代码库的更改分支。

    变更代码库

    如果项目使用了 multiple remote repositories ,您也可以在此弹窗中更改 head 代码库。

  5. 标题 字段中为您的合并请求指定名称,并可选择性地提供更改说明并添加审阅人。

  6. 单击 创建合并请求

管理传入合并请求

要查看传入的合并请求,请在左侧工具窗口栏中单击 GitLab 图标

合并请求筛选器

或者,转到主菜单中的 Git|GitLab|显示 GitLab 合并请求

使用 合并请求 工具窗口可:

  • 审查合并请求 :浏览代码,检查建议更改与基础版本之间的差异,并直接在 WebStorm 中留下评论。

  • 按状态、作者、指派人、审阅人和标签 筛选请求

  • 跳转到 GitLab 上的合并请求 :右键单击合并请求并在上下文菜单中选择 在 GitLab 上打开合并请求

  • 基于传入更改创建本地分支 :打开合并请求,点击包含更改的分支,并在上下文菜单中选择 检出 'branch name'

  • 日志 选项卡中的 Git 工具窗口中 调查与分支相关的更改 :打开合并请求,点击包含更改的分支,并在上下文菜单中选择 在 Git 日志中显示 'branch name'

    这将帮助您浏览与该合并请求相关的代码,确保项目可以构建并通过测试。

  • 解决合并冲突 :如果传入合并请求中的分支存在合并冲突,您可以在 合并请求 工具窗口中直接解决这些冲突,例如创建来自目标分支的合并提交或将其变基到目标分支上。

    解决合并冲突的选项

确保您始终获取最新的合并请求信息,请按 Ctrl+F5。 或者,右键点击所需的合并请求并选择 刷新列表

对合并请求提供反馈

当有需要您处理的更改时, GitLab 工具窗口上会显示一个白色圆点,未查看的合并请求上会标记为蓝色圆点。

  1. 在主菜单中,转到 Git|GitLab|查看合并请求

  2. 在合并请求列表中,选择您要处理的合并请求并双击。

    WebStorm 将打开所选合并请求的概览。

    合并请求概览
    • 标题旁边显示合并请求编号。 单击它即可在 GitLab 上打开合并请求。

    • 单击 查看时间线 按钮以打开合并请求时间线。

    • 如果合并请求包含多个提交,可在 变更来源 下拉菜单中选择要关注的提交。 使用上下按钮在提交之间导航。

    • 右键点击任意文件以打开该文件的上下文菜单。

    • 若审阅者留下了任何评论或建议,文件列表中将显示评论数量计数器。

  3. 单击包含传入更改的分支,并在上下文菜单中选择 检出 'branch name' 以启动审查模式。

    签出包含传入更改的分支
  4. 选择要查看的文件,右键单击并在菜单中选择 跳转到源 F4

    在打开的文件中,边缘的粉色标记表示可供审查的更改与评论。

    单击边缘的评论图标可隐藏或打开评论。

    审查模式中的更改与评论

    单击粉色标记将弹出显示原始代码的窗口。

    审查模式 — 查看差异
  5. 将鼠标悬停在边缘区域并单击 可添加评论。

    带建议的评论字段
    • 选择 添加评论 可立即发布评论并通知其他审阅者。

    • 选择 保存为草稿 可添加多个评论。

      在提交审查前,您的评论将标记为 待处理 ,您可以编辑或删除这些评论。

  6. 若要对整个合并请求添加高层级注释,请打开此合并请求的时间线视图。

  7. 点击合并请求详情选项卡中的 提交审查 以提交评审或批准合并请求。

    提交审查对话框

    请选择一个可能的结果:

    • 批准 :用于批准更改的合并。

    • 提交 :用于提交您的反馈,但不做批准。

    如果您改变主意,可以稍后点击 撤销批准 按钮。

如果已完成对合并请求的处理,您可以在同一个合并请求详情选项卡中合并或关闭它。

在合并请求中处理评论

如果有人对您的合并请求留下了评论,您可以在 WebStorm 中直接解决或回复这些评论。

  1. 在主菜单中,前往 Git|GitLab|查看合并请求 ,或点击左侧工具窗口栏中的 GitLab 图标

  2. 从列表中选择合并请求并双击。 WebStorm 将打开所选合并请求的概览。

  3. 双击文件以查看建议的更改。

  4. 您可以解决评论、回复评论或添加表态。

    GitLab 审查评论

完成合并请求的工作后,您可以在同一个合并请求详情选项卡中重新请求评审、合并或关闭它。

合并或关闭合并请求

提交评审并解决所有问题后,您可以合并或关闭合并请求。

  1. 在主菜单中,前往 Git|GitLab|查看合并请求

  2. 在合并请求列表中,选择您要处理的请求并双击。

  3. 在概览底部,有一个合并选项按钮,其显示内容会根据评审流程的阶段有所不同。

    • 如果您在评审后批准了更新内容,可以通过点击 合并 来合并合并请求。

      如需查看更多合并选项,请点击 向下箭头 并选择 压缩并合并 ,以在合并之前将包含更改的提交压缩为一个。

    • 点击 更多 并选择 请求审查 以征求他人对此合并请求的意见,或选择 关闭合并请求 以放弃合并。

最后修改日期: 2025年 9月 26日