PhpStorm 2025.2 Help

使用标签标记特定 Git 提交

Git 允许您将标签附加到提交以标记项目历史中的某些点,以便将来参考。 例如,您可以标记与某个发行版本对应的提交,而不是 创建一个分支来捕获发行快照。

在 PhpStorm 中,您可以在 Git 分支 弹出窗口中执行与标签相关的操作。 要调用它,请在主窗口标题中点击当前签出的分支名称的 Git 小部件:

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

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

分支窗格

为提交分配标签

  1. 打开 Git 工具窗口 Alt+9 并切换到 日志 标签页。

  2. 找到您需要的提交记录,右键点击它,然后从上下文菜单中选择 新建标签

  3. 请输入新标签的名称,然后点击 确定。 该标签将显示在 日志 选项卡的 Git 工具窗口 Alt+9 中:

    标记提交

为提交分配注释标签

元数据中包含了创建 注释标签的用户名称,因此您可以检查是谁放置了它们。

  1. 在主菜单中,进入 Git | 新标签.

  2. Tag 弹窗中, 在 Git 根目录 下,选择您想要标记提交的本地仓库路径,并指定新标签的名称。

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

  4. 消息 字段中输入一些评论以创建一个 注释标签(如果为空,将创建一个常规标签)。

  5. 点击 创建标签

重新分配现有标签

如果您在错误的提交上放置了标签,并希望重新分配它(例如,指示发布版本的提交),请执行以下操作:

  1. 在主菜单中,进入 Git | 新标签.

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

  3. 请选择 强制 选项。

  4. Commit 字段中,指定要移动标签的 commit,然后点击 创建标签

跳转到标记的提交

  1. 打开 Git 工具窗口 Alt+9 并切换到 日志 标签页。

  2. 请点击工具栏上的 转到哈希/分支/标签 图标 ,或者按 Ctrl+F 键。

    转到 Hash/Branch/Tag 图标
  3. 输入标签名称(代码补全 会在您输入时建议标签名称),然后按 Enter

查看标记的提交

假设您用标签标记了与发行版本对应的提交,现在您想查看那个时间点的项目快照。 您可以通过检出带标签的提交来实现此操作。 请执行以下操作之一:

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

  • Git 工具窗口 Alt+9 中,打开 选项卡 节点,选择必要的标签并从上下文菜单中的操作列表中选择 检出

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

  • 调用分支弹出窗口 ,打开 选项卡 节点,选择必要的标签并从上下文菜单中的操作列表中选择 检出

请注意,此操作会导致出现一个 分离的 HEAD ,这意味着您不再处于任何分支中。 您可以使用此快照进行检查和实验。 但是,如果您想在此快照之上提交更改,则需要 创建一个分支

获取标签

当您从上游 fetch changes 时,可以设置 Git 获取标签的方式。

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

  2. 选择首选项:

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

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

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

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

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

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

推送标签

默认情况下,当您执行 push 操作时,标签不会发送到远程存储库。

要推送特定标签,可以调用 分支弹出窗口Git 工具窗口 Alt+9 ,打开 选项卡 节点,选择必要的标签并从上下文菜单中的操作列表中选择 推送到源

要将多个标签与提交一起推送:

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

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

    • 选择 全部 如果您想推送所有标签,包括不属于您即将推送的选定分支的标签(相当于 push --tags)。

    • 选择 当前分支 如果您只想推送属于您即将推送的选定分支的标签(相当于 push --follow-tags)。

  3. 点击 推送

删除标签

  • 定位 一个标记的提交,右键点击它,然后从上下文菜单中选择 标签 <tag_name> | 删除

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

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

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