搜尋程式碼集

產品總覽

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

開始使用

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

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

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

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

搜尋框位於畫面上方。您可以使用這個方塊搜尋特定檔案和程式碼。

使用存放區

開啟存放區

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

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

切換存放區

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

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

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

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

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

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

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

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

使用檔案

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

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

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

開啟檔案

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

查看檔案異動

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

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

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

查看變更記錄

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

1. 在存放區檢視畫面中選取檔案。
2. 按一下右上角的「歷史記錄」。「變更記錄」窗格隨即顯示，內含這個檔案的修訂項目。

查看程式碼審查

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

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

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

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

在特定修訂版本開啟檔案

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

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

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

如要比較不同修訂版本的檔案，請按照下列步驟操作：

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

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

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

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

瀏覽交叉參照

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

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

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

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

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

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

您可以繼續使用「交叉參照」窗格瀏覽交叉參照，就像在「檔案」窗格中一樣。這麼做時，窗格會顯示導覽標記記錄，方便您在不同的交叉參照之間導覽。

搜尋程式碼

您可以使用畫面頂端的搜尋框，尋找特定檔案或程式碼片段。搜尋作業一律會針對預設分支版本執行。

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

注意：如要快速搜尋特定檔案，請在句點前方加上反斜線，或是將整個檔案名稱括在引號內。

foo\.java
"foo.java"

您可以使用下列篩選器調整搜尋範圍。

其他支援

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