搜索代码库

报告问题 查看来源 每晚 · 7.2。 · 7.1敬上 · 7.0 · 6.5 · 6.4。

产品概览

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

使用入门

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

此时会显示主屏幕。此屏幕包含以下组件：

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

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

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

使用代码库

打开代码库

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

此外，您还可以使用“路径”工具栏 特定代码库此工具栏显示您当前在代码库中的位置，利用它可以快速转到另一个位置（例如另一个代码库）或代码库内的另一个位置（例如文件、分支或提交）。

切换代码库

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

查看特定提交时的代码库

如需在特定提交中查看代码库，请执行以下操作：

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

界面现在会显示提交时存在的代码库。

打开分支、提交或标记

默认情况下，代码搜索和源代码浏览界面会打开一个代码库 默认分支。要打开其他分支，请从“路径”工具栏中 点击分支/提交/标记菜单。系统会打开一个子菜单，供您选择 使用分支名称、标记名称或搜索框搜索分支。

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

使用文件

从主屏幕选择代码库后，屏幕会更改为显示 该代码库的视图如果存在 README 文件，则其内容会显示在 文件窗格。否则， 代码库的文件和文件夹中显示的文件。屏幕左侧是一棵树 查看代码库的文件和文件夹您可以使用这种树状结构 打开特定文件。

请注意，当您查看代码库时，“路径”工具栏现在会显示 三个组成部分：

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

打开文件

您可以浏览到文件目录并选择该文件，从而打开该文件。视图 相应代码库会更新，以在文件窗格中显示文件的内容；以及 在代码库的树形窗格中的位置。

查看文件更改

如需查看文件更改，请执行以下操作：

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

文件窗格会更新，以显示更改文件的人员以及更改时间。

查看更改历史记录

要查看文件的更改历史记录，请执行以下操作：

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

查看代码审核

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

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

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

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

在特定提交时打开文件

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

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

将文件与不同的提交进行比较

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

  1. 从代码库视图中，选择该文件。比较两个 请先在该提交时打开文件。
  2. 将鼠标悬停在提交上。系统会显示 DIFF 按钮。
  3. 点击区分按钮。

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

在“更改历史记录”窗格中，这两项提交均会突出显示，并有一个标签指示 如果提交显示在左侧或右侧。

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

浏览交叉引用

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

如需使交叉引用更易于识别，请点击交叉引用。 图标。此选项会在所有单元格下方显示下划线 交叉引用。

注意：如果交叉引用呈灰显状态，则表示 交叉引用。

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

  • 定义部分，其中列出了定义 参考信息
  • “References”（参考）部分，其中列出了包含相应参考的文件 出现

这两个部分都显示文件的名称以及一个或多个行 包含该引用。如需从“交叉引用”窗格中打开文件，请执行以下操作： 点击行号条目相应文件会显示在窗格的一个新部分中， 您可以继续浏览文件，同时保留原始文件 可见。

您可以继续使用“交叉引用”窗格浏览交叉引用 就像在“文件”窗格中执行的操作一样。添加后，该窗格会显示浏览路径记录 可用于在不同交叉引用之间导航。

您可以使用位于以下位置的搜索框来搜索特定的文件或代码段 。搜索始终针对默认分支。

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

注意：如需快速搜索特定文件，您可以在文件前面添加反斜杠， 或将整个文件名括在引号中。

foo\.java
"foo.java"

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

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

更多支持

如要报告问题，请点击顶部显示的反馈按钮 ，然后在提供的表单中输入您的反馈。