产品概览
Bazel 的代码搜索和源代码浏览界面是一款基于网络的工具,用于浏览 Bazel 源代码库。您可以使用这些功能在不同代码库、分支和文件之间导航。您还可以查看历史记录、差异和追责信息。
开始使用
如需访问代码搜索和源代码浏览界面,请在网络浏览器中打开 https://source.bazel.build。
系统会显示主屏幕。此屏幕包含以下组件:
“面包屑导航”工具栏。此工具栏显示您当前在代码库中的位置,利用它可以快速转到另一个位置(例如另一个代码库)或代码库内的另一个位置(例如文件、分支或提交)。
您可以浏览的代码库列表。
屏幕顶部有一个搜索框。您可以使用此框搜索特定文件和代码。
使用代码库
打开代码库
如需打开代码库,请在主屏幕中点击其名称。
或者,您也可以使用面包屑导航工具栏浏览特定代码库。此工具栏显示您当前在代码库中的位置,利用它可以快速转到另一个位置(例如另一个代码库)或代码库内的另一个位置(例如文件、分支或提交)。
切换代码库
如需切换到其他代码库,请从“路径”工具栏中选择相应代码库。
查看特定提交内容的代码库
如需查看特定提交内容的代码库,请执行以下操作:
- 从代码库视图中选择该文件。
- 从“路径”工具栏中打开分支菜单。
- 在出现的子菜单中,点击提交。
- 选择要查看的提交。
现在,接口会显示该提交中的代码库。
打开一个分支、提交或标记
默认情况下,代码搜索和源代码浏览界面会向默认分支打开代码库。如需打开其他分支,请从“路径”工具栏中点击分支/提交/标记菜单。系统会打开一个子菜单,您可以在其中使用分支名称、标记名称或搜索框选择分支。
- 要使用分支名称选择分支,请选择分支,然后点击分支的名称。
- 要使用标记名称选择分支,请选择标记,然后点击标记名称。
- 要使用提交 ID 选择分支,请选择提交,然后点击提交 ID。
- 如需搜索分支、提交或标记,请选择相应的条目,然后在搜索框中输入搜索字词。
使用文件
从主屏幕选择代码库时,屏幕会更改为显示该代码库的视图。如果存在 README 文件,其内容会显示在位于屏幕右侧的文件窗格中。否则,系统会显示代码库的文件和文件夹列表。屏幕左侧是代码库文件和文件夹的树状视图。您可以使用此树浏览和打开特定文件。
请注意,当您查看代码库时,面包屑导航工具栏现在包含三个组件:
- 代码库菜单,您可以从中选择不同的代码库
- 分支/提交/标记菜单,您可以从中选择特定分支、标记或提交
- 文件路径框,其中显示了当前文件或文件夹的名称及其对应的路径
打开文件
您可以浏览并选择相应文件,将其打开。代码库视图会更新以显示文件窗格中的文件内容,以及该文件在树窗格中的代码库位置。
查看文件更改
如需查看文件更改,请执行以下操作:
- 从代码库视图中选择该文件。
- 点击右上角的追责 (Blame)。
文件窗格会更新,以显示谁对文件进行了更改以及更改时间。
查看更改历史记录
要查看文件的更改历史记录,请执行以下操作:
- 从代码库视图中选择该文件。
- 点击右上角的记录。 系统会显示更改历史记录窗格,显示此文件的提交内容。
查看代码审核
对于 Gerrit 代码审核,您可以直接从“更改历史记录”窗格打开该工具。
如需查看文件的代码审核,请执行以下操作:
- 从代码库视图中选择该文件。
- 点击右上角的记录。此时将显示“更改历史记录”窗格,其中显示此文件的提交。
- 将鼠标悬停在提交内容上。系统会显示更多按钮(三个垂直排列的点)。
- 点击更多按钮。
- 选择查看代码审核。
Gerrit Code Review 工具会在新的浏览器窗口中打开。
打开特定提交的文件
如需打开特定提交的文件,请执行以下操作:
- 从代码库视图中选择该文件。
- 点击右上角的记录。此时将显示“更改历史记录”窗格,其中显示此文件的提交。
- 将鼠标悬停在提交内容上。系统会显示 VIEW 按钮。
- 点击查看按钮。
比较文件与其他提交内容
如需比较不同提交的文件,请执行以下操作:
- 从代码库视图中选择该文件。如需通过两个不同的提交内容进行比较,请先在该提交内容中打开文件。
- 将鼠标悬停在提交内容上。系统会显示 DIFF 按钮。
- 点击 DIFF 按钮。
文件窗格会更新,以显示两个文件之间的并排比较。两次提交时间中时间最早的是左侧。
在“更改历史记录”窗格中,两个提交内容都会突出显示,还有一个标签用于表明是显示在左侧还是右侧。
如需更改任一文件,请将鼠标指针悬停在“更改历史记录”窗格中的提交上。然后,点击 Left 或 Right 按钮,使提交内容显示在 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” |
更多支持
如需报告问题,请点击屏幕右上角的反馈按钮,然后在提供的表单中输入您的反馈。