WebStorm 2025.2 Help

Git 与问题跟踪器集成

使用 WebStorm,您可以将提交消息与缺陷跟踪器或问题数据库连接,并从版本控制系统日志中的提交导航到与这些提交相关的问题。

  1. Ctrl+Alt+S 打开设置,然后选择 版本控制|问题导航

  2. 使用此对话框创建 issue navigation patterns 列表。

    问题导航设置

    issue navigation pattern 会将提交消息中的 issue ID pattern 映射到所引用问题的 URL 地址。 这样,您便可从已提交的更改导航到与这些更改相关的问题。 一旦 WebStorm 在提交消息中检测到符合 issue ID pattern 的内容,该匹配项就会作为链接显示在 版本控制 工具窗口 Alt+9 中。 如果提到了多个问题,它们都将显示为链接。 点击此类链接将会在默认浏览器中打开对应的问题。

    问题导航 设置中, 问题 是只读字段,用于显示 issue pattern。 链接 是只读字段,用于显示从当前行中的 issue pattern 导航到缺陷跟踪系统中问题的链接。

    点击 添加 配置 issue navigation patterns 列表,将提交消息中的 issue pattern 映射到所引用问题的 URL 地址。

    • 如果使用的是 JIRAYouTrack ,请点击工具栏中的 添加 JIRA 模式添加 YouTrack 模式 ,并输入缺陷跟踪系统的安装地址。

      WebStorm 会自动添加定义导航模式的正则表达式。

    • 对于其他问题跟踪系统,点击 添加问题导航链接 创建新条目,或点击 编辑 编辑现有条目。 在打开的对话框中,指定以下正则表达式:

示例

下方示例显示了 WebStorm 如何应用上述规则来检测提交消息中对问题的引用,并在问题跟踪系统中构建对应的链接。

添加问题导航链接对话框

Issue ID

定义提交消息中问题引用格式的 regular expression

[A-Z]+\-\d+

此正则表达式匹配所有由两个子字符串组成、并以 n-dash 字符分隔的字符串:

  1. 子字符串 1:任意数量的大写英文字母。

  2. 子字符串 2:任意数量的数字字符。

您的问题跟踪系统的 URL 地址和用于识别问题的正则表达式的组合。

http://<mytracker>/issue/$0

此处 $0 表示对整个匹配项的反向引用。 这意味着,一旦 WebStorm 在提交消息中检测到匹配项,该匹配项将按原样添加到跟踪器的 URL 地址中。

匹配的 Issue ID

WebStorm 在目标提交消息中检测到以下问题引用:

MYPROJECT-110

组合的问题链接

根据上方的问题导航模式,检测到的匹配引用将按原样添加至跟踪器的 URL 中,从而构建出如下所示的问题链接:

http://mytracker/issue/MYPROJECT-110
最后修改日期: 2025年 9月 26日