搜索代码库

<ph type="x-smartling-placeholder"></ph> 报告问题 查看来源 敬上 每晚 · 7.3。 · 7.2 条 · 7.1敬上 · 7.0。 · 6.5

产品概览

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. 点击区分按钮。

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

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

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

浏览交叉引用

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

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

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

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

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

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

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

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

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

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

foo\.java
"foo.java"

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

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

更多支持

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