搜尋程式碼集

產品總覽

Bazel 的程式碼搜尋和原始碼瀏覽介面是用於瀏覽 Bazel 原始碼存放區的網頁工具。您可以使用這些功能瀏覽不同的存放區、分支和檔案。您也可以查看修訂記錄、差異和歸咎資訊。

開始使用

如要存取程式碼搜尋和原始碼瀏覽介面，請在網路瀏覽器中開啟 https://source.bazel.build。

主畫面隨即顯示。這個畫面包含下列元件：

1. 導覽標記工具列。此工具列會顯示您在存放區中的目前位置，並允許您迅速移動至另一個位置 (例如另一個存放區) 或存放區內的另一個位置 (例如檔案、分支版本或修訂版本)。

2. 可供瀏覽的存放區清單。

畫面頂端有一個搜尋框。您可以使用這個方塊搜尋特定檔案和程式碼。

使用存放區

開啟存放區

如要開啟存放區，請在主畫面中按一下存放區名稱。

或者您可使用導覽標記工具列瀏覽特定存放區。此工具列會顯示您在存放區中的目前位置，並允許您迅速移動至另一個位置 (例如另一個存放區) 或存放區內的另一個位置 (例如檔案、分支版本或修訂版本)。

切換存放區

如要切換至其他存放區，請從導覽標記工具列中選取存放區。

查看特定修訂版本的存放區

如要查看特定修訂版本的存放區，請按照下列步驟操作：

1. 在存放區檢視畫面中選取檔案。
2. 在導覽標記工具列中開啟「Branch」選單。
3. 在隨即顯示的子選單中，按一下「提交」。
4. 選取要查看的修訂版本。

介面現在會顯示該修訂版本的存放區。

開啟分支版本、修訂版本或標記

根據預設，程式碼搜尋和原始碼瀏覽介面會開啟預設分支版本的存放區。如要開啟其他分支版本，請在導覽標記工具列中按一下「Branch/Commit/Tag」選單。系統會開啟子選單，讓您使用分支版本名稱、標記名稱或搜尋框選取分支版本。

• 若要使用分支版本名稱選取分支版本，請選取 [Branch] (分支版本) 並按一下分支版本的名稱。
• 若要使用標記名稱選取分支版本，請選取「Tag」，然後按一下標記名稱。
• 若要使用修訂版本 ID 選取分支版本，請選取 [Commit] (修訂版本) 並按一下修訂版本 ID。
• 如要搜尋分支版本、修訂版本或標記，請選取對應的項目，然後在搜尋框中輸入搜尋字詞。

使用檔案

從主畫面選取存放區時，畫面會變更為顯示該存放區的檢視畫面。如果有 README 檔案，其內容會顯示在檔案窗格中，位於畫面右側。否則，系統會顯示存放區的檔案和資料夾清單。畫面左側為存放區檔案和資料夾的樹狀結構。您可以使用這個樹狀結構瀏覽及開啟特定檔案。

請注意，當您查看存放區時，導覽標記工具列現在有三個元件：

• 「Repository」選單，可用於選取不同的存放區
• 「分支版本/修訂版本/標記」選單，可用來選取特定分支版本、標記或修訂版本
• 「File path」方塊，顯示目前檔案或資料夾的名稱及其對應路徑

開啟檔案

您可以瀏覽目錄並選取檔案來開啟檔案。存放區檢視畫面會更新，在檔案窗格中顯示檔案內容，以及在樹狀結構的存放區位置。

查看檔案變更

如要查看檔案異動，請按照下列步驟操作：

1. 在存放區檢視畫面中選取檔案。
2. 按一下右上角的 [BLAME] (改動記錄)。

檔案窗格會更新，顯示誰在何時對檔案做了哪些變更。

查看變更記錄

如要查看檔案的變更記錄，請按照下列步驟操作：

1. 從存放區檢視畫面選取檔案。
2. 按一下右上角的「歷史記錄」。「變更記錄」窗格隨即顯示，並列出此檔案的修訂版本。

查看程式碼審查

如要進行 Gerrit 程式碼審查，您可以直接透過「變更記錄」窗格開啟這項工具。

如要查看檔案的程式碼審查內容，請按照下列步驟操作：

1. 在存放區檢視畫面中選取檔案。
2. 按一下右上角的「歷史記錄」。隨即會出現「變更記錄」窗格，顯示這個檔案的修訂版本。
3. 將滑鼠游標懸停在修訂版本上。畫面上會顯示「More」按鈕 (三個垂直排列的圓點)。
4. 按一下「更多」按鈕。
5. 選取「查看程式碼審查」。

Gerrit Code Review 工具會在新瀏覽器視窗中開啟。

在特定修訂版本開啟檔案

如何在特定修訂版本開啟檔案：

1. 在存放區檢視畫面中選取檔案。
2. 按一下右上角的「歷史記錄」。隨即會出現「變更記錄」窗格，顯示這個檔案的修訂版本。
3. 將滑鼠游標懸停在修訂版本上。畫面上會顯示「VIEW」按鈕。
4. 按一下「查看」按鈕。

比較檔案與不同的修訂版本

如何比較不同修訂版本中的檔案：

1. 在存放區檢視畫面中選取檔案。如要比較兩個不同的修訂版本，請先開啟該修訂版本的檔案。
2. 將滑鼠游標懸停在修訂版本上。畫面上會顯示「DIFF」DIFF按鈕。
3. 按一下「DIFF」DIFF按鈕。

檔案窗格會更新，顯示兩個檔案的並列比較結果。兩次提交中較早的提交一律會顯示在左側。

「變更記錄」窗格的兩個修訂版本都會醒目顯示，而一個標籤會指出修訂版本會顯示在左側或右側。

若要變更任一檔案，請將滑鼠遊標懸停在「變更記錄」窗格中的修訂版本。接著，按一下「左」或「右」按鈕，在差異比較畫面的左側或右側開啟提交。

瀏覽交叉參照

瀏覽來源存放區的另一種方法是使用交叉參照。這些參照會自動顯示為特定來源檔案中的超連結。

如要輕鬆識別交叉參照，請按一下右上角的「Cross References」。這個選項會在檔案中的所有交叉參照下方顯示底線。

注意：如果「交叉參照」呈現灰色，表示該檔案不支援交叉參照。

按一下交叉參考資料，開啟「交叉參照」窗格。這個窗格包含兩個部分：

• 「定義」部分，列出定義參照的檔案
• 「參考資料」區段：列出參考資料出現的檔案

這兩個部分都會顯示檔案名稱，以及包含參照的列。如要從「交叉參照」窗格開啟檔案，請按一下行號項目。檔案會顯示在窗格的新區段，您可以繼續瀏覽檔案，同時將原始檔案保留在檢視畫面中。

您可以繼續使用「交叉參照」窗格瀏覽交叉參照，就像在「檔案」窗格中一樣。這時窗格會顯示麵包屑軌跡，方便您在不同交叉參照之間瀏覽。

搜尋程式碼

您可以使用畫面頂端的搜尋框，尋找特定檔案或程式碼片段。系統一律會根據預設分支版本進行搜尋。

所有搜尋皆預設使用 RE2 規則運算式。如果您不想要使用規則運算式，請用雙引號 ( " ) 括住您的搜尋。

注意：如要快速搜尋特定檔案，請在半形句號前面加上反斜線，或用引號括住整個檔案名稱。

foo\.java
"foo.java"

如要修正搜尋範圍，請使用下列篩選器。

其他支援

如要回報問題，請按一下畫面右上角的「意見回饋」按鈕，然後在提供的表單中輸入意見回饋。