搜索代码库

产品概览

Bazel 的代码搜索和源代码浏览界面是一款基于网络的工具,用于浏览 Bazel 源代码库。您可以使用这些功能在不同的代码库、分支和文件之间导航。您还可以查看历史记录、差异和问题信息。

开始使用

如需访问代码搜索和源代码浏览界面,请在网络浏览器中打开 https://source.bazel.build

系统随即会显示主屏幕。该屏幕包含以下组件:

  1. “路径”工具栏。此工具栏显示您当前在代码库中的位置,利用它可以快速转到另一个位置(例如另一个代码库)或代码库内的另一个位置(例如文件、分支或提交)。

  2. 您可以浏览的代码库的列表。

屏幕顶部是一个搜索框。您可以使用此框搜索特定文件和代码。

使用代码库

打开代码库

如需打开代码库,请在主屏幕中点击其名称。

或者,您也可以使用“路径”工具栏浏览并找到特定的代码库。此工具栏显示您当前在代码库中的位置,利用它可以快速转到另一个位置(例如另一个代码库)或代码库内的另一个位置(例如文件、分支或提交)。

切换代码库

如需切换到其他代码库,请从“路径”工具栏中选择相应代码库。

执行特定提交时查看代码库

如需在特定提交下查看代码库,请执行以下操作:

  1. 从代码库视图中,选择该文件。
  2. 从“路径”工具栏中,打开分支菜单。
  3. 在显示的子菜单中,点击提交
  4. 选择要查看的提交。

接口现在会显示该代码库在该提交时存在。

打开分支、提交或标记

默认情况下,代码搜索和源代码浏览界面会打开代码库并进入默认分支。如需打开其他分支,请从“路径”工具栏中点击分支/提交/标记菜单。此时将打开一个子菜单,您可以使用分支名称、标记名称或通过搜索框选择分支。

  • 要使用分支名称选择分支,请选择分支,然后点击分支的名称。
  • 如需使用标记名称选择分支,请选择标记,然后点击标记名称。
  • 要使用提交 ID 选择分支,请选择提交,然后点击提交 ID。
  • 要搜索分支、提交或标记,请选择相应项,然后在搜索框中输入搜索字词。

使用文件

从主屏幕中选择代码库时,屏幕会更改为显示该代码库的视图。如果存在 README 文件,其内容会显示在屏幕右侧的文件窗格中。否则,系统会显示代码库的文件和文件夹列表。屏幕左侧是代码库文件和文件夹的树状视图。您可以使用此树浏览和打开特定文件。

请注意,当您查看代码库时,面包屑导航工具栏现在包含三个组件:

  • 代码库菜单,您可以从中选择不同的代码库
  • 分支/提交/标记菜单,您可以从中选择特定分支、标记或提交
  • 文件路径框,其中显示当前文件或文件夹的名称及其对应的路径

打开文件

您可以浏览到某个文件的目录,然后选择该文件,即可将其打开。代码库视图会更新,以在文件窗格中显示文件的内容,并在树窗格中显示其在代码库中的位置。

查看文件更改

如需查看文件更改,请执行以下操作:

  1. 从代码库视图中,选择该文件。
  2. 点击右上角的追责 (Blame)。

文件窗格会更新,以显示谁更改了文件以及更改时间。

查看更改历史记录

如需查看文件的更改历史记录,请执行以下操作:

  1. 从代码库视图中,选择该文件。
  2. 点击右上角的历史记录。 此时会出现更改历史记录窗格,其中显示了此文件的提交内容。

查看代码审核

对于 Gerrit 代码审核,您可以直接从“更改历史记录”窗格中打开该工具。

如需查看文件的代码审核,请执行以下操作:

  1. 从代码库视图中,选择该文件。
  2. 点击右上角的历史记录。此时会显示“更改历史记录”窗格,其中显示了该文件的提交内容。
  3. 将鼠标悬停在提交内容上。系统随即会显示更多按钮(三个垂直排列的点)。
  4. 点击更多按钮。
  5. 选择查看代码审核

Gerrit 代码审核工具会在新的浏览器窗口中打开。

在特定提交时打开文件

如需在特定提交时打开文件,请执行以下操作:

  1. 从代码库视图中,选择该文件。
  2. 点击右上角的历史记录。此时会显示“更改历史记录”窗格,其中显示了该文件的提交内容。
  3. 将鼠标悬停在提交内容上。系统随即会显示查看按钮。
  4. 点击查看按钮。

将文件与另一项提交进行比较

如需比较不同提交中的文件,请执行以下操作:

  1. 从代码库视图中,选择该文件。如需与两个不同的提交内容进行比较,请先打开该提交对应的文件。
  2. 将鼠标悬停在提交内容上。系统会显示 DIFF 按钮。
  3. 点击差异按钮。

文件窗格会更新,以显示两个文件之间的并排比较。两个提交内容中时间最早的提交内容始终位于左侧。

在“更改历史记录”窗格中,两个提交内容都会突出显示,并且一个标签会指示提交内容是显示在左侧还是右侧。

如需更改任一文件,请将鼠标悬停在“更改历史记录”窗格中的提交内容上。然后,点击按钮,以在差异的左侧或右侧打开提交内容。

浏览交叉引用

浏览源代码库的另一种方法是使用交叉引用。这些引用会自动以超链接的形式显示在给定源文件中。

为了便于识别交叉引用,请点击右上角的交叉引用。此选项会在文件中的所有交叉引用下方显示下划线。

注意:如果交叉引用呈灰显状态,则表示交叉引用不适用于该文件。

点击某个交叉引用以打开“Cross Reference”窗格。此窗格包含两个部分:

  • Definition 部分,用于列出定义引用的文件
  • References 部分,其中列出了同样包含参考文件的文件

这两个部分都会显示文件的名称以及包含引用的一行或多行。如需从“Cross Reference”窗格中打开文件,请点击行号条目。该文件会显示在窗格的新部分中,让您可以继续浏览文件,同时保留原始文件。

您可以继续使用“交叉引用”窗格浏览交叉引用,就像在“文件”窗格中一样。执行此操作后,此窗格会显示面包屑导航路径,您可以使用它在不同的交叉引用之间导航。

您可以使用屏幕顶部的搜索框搜索特定文件或代码段。搜索始终针对默认分支。

默认情况下,所有搜索都使用 RE2 正则表达式。如果您不想使用正则表达式,请使用英文双引号 ( " ) 将搜索内容括起来。

注意:如需快速搜索特定文件,请在英文句点前面添加反斜杠,或将整个文件名括在引号中。

foo\.java
"foo.java"

您可以使用以下过滤条件缩小搜索范围。

过滤 其他选项 说明 示例
lang: language: 按文件语言执行完全匹配。 lang:java 测试
文件: 文件路径:
路径:
f:
case:yes 使搜索区分大小写。默认情况下,搜索不区分大小写。 case:yes Hello World
class: 搜索类名称。 class:MainClass
function: func: 搜索函数名称。 function:print
- 从搜索中否定该字词。 你好 -世界
\ 对特殊字符进行转义,例如 .、\ 或 (. run\(\)
“[字词]” 执行字面量搜索。 "class:main"

更多支持

如需报告问题,请点击屏幕右上角的反馈按钮,然后在提供的表单中输入您的反馈。