產品總覽
Bazel 的程式碼搜尋和原始碼瀏覽介面是用於瀏覽 Bazel 原始碼存放區的網頁工具。您可以使用這些功能瀏覽不同的存放區、分支版本和檔案。您也可以查看修訂記錄、差異和歸咎資訊。
開始使用
如要存取程式碼搜尋和原始碼瀏覽介面，請在網路瀏覽器中開啟 https://source.bazel.build。
主畫面隨即顯示。這個畫面包含下列元件：
導覽標記工具列。此工具列會顯示您在存放區中的目前位置，並允許您迅速移動至另一個位置 (例如另一個存放區) 或存放區內的另一個位置 (例如檔案、分支版本或修訂版本)。
可瀏覽的存放區清單。
搜尋框位於畫面上方。您可以使用這個方塊搜尋特定檔案和程式碼。
使用存放區
開啟存放區
如要開啟存放區，請在主畫面中按一下存放區名稱。
或者您可使用導覽標記工具列瀏覽特定存放區。此工具列會顯示您在存放區中的目前位置，並允許您迅速移動至另一個位置 (例如另一個存放區) 或存放區內的另一個位置 (例如檔案、分支版本或修訂版本)。
切換存放區
如要切換至不同的存放區，請從導覽標記工具列中選取存放區。
查看特定修訂版本的存放區
如要查看特定修訂版本的存放區，請按照下列步驟操作：
- 在存放區檢視畫面中選取檔案。
- 在導覽標記工具列中開啟「Branch」選單。
- 在隨即顯示的子選單中，按一下「提交」。
- 選取要查看的修訂版本。
介面現在會顯示該修訂版本的存放區。
開啟分支版本、修訂版本或標記
根據預設，程式碼搜尋和原始碼瀏覽介面會開啟預設分支版本的存放區。若要開啟其他分支版本，請按一下導覽標記工具列中的「Branch/Commit/Tag」選單。系統會開啟子選單，讓您使用分支版本名稱、標記名稱或搜尋框選取分支版本。
- 若要使用分支版本名稱選取分支版本，請選取 [Branch] (分支版本) 並按一下分支版本的名稱。
- 若要使用標記名稱選取分支版本，請選取「Tag」(標記)，然後按一下標記名稱。
- 若要使用修訂版本 ID 選取分支版本，請選取 [Commit] (修訂版本) 並按一下修訂版本 ID。
- 如要搜尋分支版本、修訂版本或標記，請選取對應的項目，然後在搜尋框中輸入搜尋字詞。
使用檔案
從主畫面選取存放區後，畫面會變更為該存放區的檢視畫面。如果有 README 檔案，其內容會顯示在檔案窗格中，位於畫面右側。否則，系統會顯示存放區的檔案和資料夾清單。畫面左側會顯示存放區檔案和資料夾的樹狀檢視畫面。您可以使用這個樹狀結構瀏覽及開啟特定檔案。
請注意，當您查看存放區時，導覽標記工具列現在有三個元件：
- 「Repository」選單，可用於選取不同的存放區
- 「Branch/Commit/Tag」選單，您可以在此選取特定分支版本、標記或修訂版本
- 「File path」方塊：顯示目前檔案或資料夾的名稱及其對應路徑
開啟檔案
您可以瀏覽目錄並選取檔案來開啟檔案。存放區的檢視畫面會更新，在檔案窗格中顯示檔案內容，並在樹狀圖窗格中顯示檔案在存放區的位置。
查看檔案異動
如要查看檔案異動，請按照下列步驟操作：
- 從存放區檢視畫面選取檔案。
- 按一下右上角的 [BLAME] (改動記錄)。
檔案窗格會更新，顯示誰在何時對檔案做了哪些變更。
查看變更記錄
如要查看檔案的變更記錄，請按照下列步驟操作：
- 在存放區檢視畫面中選取檔案。
- 按一下右上角的「歷史記錄」。「變更記錄」窗格隨即顯示，內含這個檔案的修訂項目。
查看程式碼審查
如要進行 Gerrit 程式碼審查，您可以直接透過「變更記錄」窗格開啟這項工具。
如要查看檔案的程式碼審查內容，請按照下列步驟操作：
- 從存放區檢視畫面選取檔案。
- 按一下右上角的「歷史記錄」。「變更記錄」窗格隨即顯示，並列出此檔案的修訂版本。
- 將滑鼠游標懸停在修訂版本上。系統隨即會顯示「更多」按鈕 (三個垂直排列的圓點)。
- 按一下「更多」按鈕。
- 選取「查看程式碼審查」。
Gerrit Code Review 工具會在新瀏覽器視窗中開啟。
在特定修訂版本開啟檔案
如何在特定修訂版本開啟檔案：
- 在存放區檢視畫面中選取檔案。
- 按一下右上角的「歷史記錄」。「變更記錄」窗格隨即顯示，並列出此檔案的修訂版本。
- 將滑鼠游標懸停在修訂版本上。畫面上會顯示「VIEW」按鈕。
- 按一下「查看」按鈕。
比較檔案與不同的修訂版本
如要比較不同修訂版本的檔案，請按照下列步驟操作：
- 在存放區檢視畫面中選取檔案。如要比較兩個不同的修訂版本，請先開啟該修訂版本的檔案。
- 將滑鼠游標懸停在修訂版本上。系統會隨即顯示「DIFF」DIFF按鈕。
- 按一下「DIFF」DIFF按鈕。
檔案窗格會更新，顯示兩個檔案的並列比較結果。兩次提交中較早的提交一律會顯示在左側。
「變更記錄」窗格的兩個修訂版本都會醒目顯示，而一個標籤會指出修訂版本會顯示在左側或右側。
若要變更任一檔案，請將滑鼠遊標懸停在「變更記錄」窗格中的修訂版本。接著，按一下「左」或「右」按鈕，在差異比較畫面的左側或右側開啟提交。
瀏覽交叉參照
使用交叉參照是瀏覽來源存放區的另一種方式。這些參照會自動顯示為特定來源檔案中的超連結。
如要更輕鬆地識別交叉參照，請按一下右上角的「交叉參照」。這個選項會在檔案的所有交叉參照下方顯示底線。
注意：如果「交叉參照」呈現灰色，表示該檔案不支援交叉參照。
按一下交叉參考資料，即可開啟「交叉參考資料」窗格。此窗格包含兩個部分：
- 「定義」部分，列出定義參照的檔案
- 「參考資料」區段：列出參考資料出現的檔案
這兩個部分都會顯示檔案名稱，以及包含參照的列。如要從「交叉參考資料」窗格開啟檔案，請按一下行號項目。檔案會顯示在窗格的新區段，您可以繼續瀏覽檔案，同時將原始檔案保留在檢視畫面中。
您可以繼續使用「交叉參照」窗格瀏覽交叉參照，就像在「檔案」窗格中一樣。這麼做時，窗格會顯示導覽標記記錄，方便您在不同的交叉參照之間導覽。
搜尋程式碼
您可以使用畫面頂端的搜尋框，尋找特定檔案或程式碼片段。搜尋作業一律會針對預設分支版本執行。
所有搜尋皆預設使用 RE2 規則運算式。如果您不想要使用規則運算式，請用雙引號 ( " ) 括住您的搜尋。
注意：如要快速搜尋特定檔案，請在句點前方加上反斜線，或是將整個檔案名稱括在引號內。
foo\.java
"foo.java"
您可以使用下列篩選器調整搜尋範圍。
| 篩選 | 其他選項 | 說明 | 範例 |
|---|---|---|---|
| lang: | 語言： | 根據檔案語言執行完全比對。 | lang:java test |
| 檔案： | filepath: path: f: |
||
| case:yes | 使搜尋區分大小寫。根據預設，搜尋不區分大小寫。 | case:yes Hello World | |
| class: | 搜尋類別名稱。 | class:MainClass | |
| function: | func: | 搜尋函式名稱。 | 函式：print |
| - | 從搜尋中排除該字詞。 | hello -world | |
| \ | 逸出特殊字元，例如 .、\ 或 (。 | run\(\) | |
| 「[字詞]」 | 執行常值搜尋。 | 「class:main」 |
其他支援
如要回報問題，請按一下畫面右上角的「意見回饋」按鈕，然後在提供的表單中輸入意見回饋。