WebStorm 2025.2 Help

使用标签标记特定 Git 提交

Git 允许您将标签附加到提交,以标记项目历史中的某些时间点,方便将来引用。 例如,您可以为对应于发布版本的提交添加标签,而不是 创建分支以捕获发布快照。

在 WebStorm 中,您可以在 Git 分支 弹出窗口中执行标签相关操作。 要调用此弹出窗口,请在主窗口标题栏中点击当前检出的分支名称旁的 Git 小组件:

分支弹出窗口中的标签节点

您还可以在 分支窗格Git 工具窗口 Alt+9 中管理标签。

分支窗格

为提交分配标签

  1. 打开 Git 工具窗口 Alt+9 并切换到 日志 选项卡。

  2. 定位所需的提交,右键点击并在上下文菜单中选择 新建标签

    为提交添加标签 - 上下文菜单
  3. 输入新标签的名称并点击 确定。 该标签将在 日志 选项卡的 Git 工具窗口 Alt+9 中显示:

    已标记的提交

为提交分配注解标签

注解标签的元数据包含创建者的名称,因此您可以查明由谁添加了标签。

  1. 在主菜单中,转到 Git | 新建标签

  2. 在打开的 标签 对话框中,在 Git 根目录 下选择要为其标记提交的本地版本库路径,并指定新标签名称。

  3. 提交 字段中,指定您要打标签的提交。 您可以输入提交哈希值,也可以使用表达式,例如: <branch>~<number of commits backwards between the latest commit (HEAD) and the required commit>。 有关详细信息,请参阅 Git 提交命名约定。

  4. 消息 字段中输入注释以创建 注解标签(若为空将创建常规标签)。

  5. 点击 创建标签

重新分配现有标签

如果您将标签标记在了错误的提交上,并希望重新分配(例如用于标识发布版本提交),请执行以下操作:

  1. 在主菜单中,转到 Git | 新建标签

  2. 标签 对话框中,在 标签名称 字段中指定您要重新分配的已有标签名称。

  3. 选择 强制 选项。

  4. 提交 字段中指定新的标签目标提交,然后点击 创建标签

跳转到带标签的提交

  1. 打开 Git 工具窗口 Alt+9 并切换到 日志 选项卡。

  2. 点击工具栏上的 转到 Hash/分支/标签 图标 ,或按下 Ctrl+F

    转到 Hash/分支/标签图标
  3. 输入标签名称(代码补全会在输入时提示标签名称),然后按下 Enter

检出带标签的提交

假设您已使用标签标记对应于发布版本的提交,现在想要查看该时间点的项目快照。 您可以通过检出带标签的提交来完成此操作。 请执行以下任一操作:

  • 定位您要检出的带标签提交,右键点击并从上下文菜单中选择 签出修订版本

  • Git 工具窗口 Alt+9 中,展开 标签 节点,选择所需标签,并在上下文菜单操作列表中选择 签出

  • 调用分支弹出窗口 ,点击 签出标签或修订版本 ,输入标签名称(WebStorm 会在输入时提供匹配标签和修订列表)。

  • 调用分支弹出窗口 ,展开 标签 节点,选择所需标签,并从上下文菜单操作列表中选择 签出

请注意,此操作会导致 分离的 HEAD 状态,这意味着您当前不位于任何分支上。 您可以使用此快照进行查看和试验。 但是,如果要基于此快照提交更改,则需要 创建分支

获取标签

您可以在从上游 提取更改时设置 Git 获取标签的方式。

  1. Ctrl+Alt+S 打开设置,然后选择 版本控制 | Git | 获取标签

  2. 选择首选的选项:

    • 自动 :遵循配置文件中指定的获取规则。

      例如,您可以为不同的远程设置不同的获取规则。 请查阅 git fetch 的文档以了解可用选项。

      如果未指定 fetch 规则,则默认情况下,Git 仅获取指向从远程仓库中下载的提交的标签。

    • 同步 :在获取更新时,移除在远程中已不存在的本地标签(与 git fetch --prune-tags 相同)。

    • 始终 :在获取更新时始终从远程获取所有标签(与 git fetch --tags 相同)。

    • 从不 :不获取指向从远程仓库中下载的提交的标签(与 git fetch --no-tags 相同)。

推送标签

默认情况下,执行 push 操作时,标签不会被推送到远程仓库。

要推送特定标签,请调出 分支弹出窗口Git 工具窗口 Alt+9 ,打开 标签 节点,选择所需标签并在上下文菜单的操作列表中选择 推送到 origin

要连同提交一起推送多个标签:

  1. 推送提交 对话框中,选择左下角的 推送标签 复选框。

    在“推送提交”对话框中推送标签
  2. 在下拉菜单中,选择要推送的标签:

    • 选择 全部 ,如果您希望推送所有标签,包括不属于即将推送的已选分支的标签(等同于 push --tags)。

    • 选择 当前分支 ,如果您只希望推送属于即将推送的已选分支的标签(等同于 push --follow-tags)。

  3. 点击 推送

删除标签

  • 定位带标签的提交,右键点击并从上下文菜单中选择 标签 <tag_name> | 删除

  • Git 工具窗口 Alt+9 中,打开 标签 节点,选择所需标签并从上下文菜单的操作列表中选择 删除

  • 调出分支弹出窗口 ,打开 标签 节点,选择所需标签并从上下文菜单的操作列表中选择 删除

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