搜索代码库

报告问题 查看源代码

产品概览

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 Code Review 工具会在新的浏览器窗口中打开。

打开特定提交的文件

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

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

比较文件与其他提交内容

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

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

文件窗格会更新,以显示两个文件之间的并排比较。两次提交时间中时间最早的是左侧。

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

如需更改任一文件,请将鼠标指针悬停在“更改历史记录”窗格中的提交上。然后,点击 LeftRight 按钮,使提交内容显示在 diff 的左侧或右侧。

浏览交叉引用

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

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

注意:如果交叉引用显示为灰色,则表示该文件不支持交叉引用。

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

  • “定义”部分,其中列出了定义引用的一个或多个文件
  • References 部分,其中列出了引用所在的文件

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

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

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

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

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

foo\.java
"foo.java"

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

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

更多支持

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