搜尋程式碼集

產品總覽

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

開始使用

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

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

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

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

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

使用存放區

開啟存放區

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

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

切換存放區

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

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

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

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

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

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

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

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

處理檔案

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

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

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

開啟檔案

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

查看檔案變更

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

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

檔案窗格會更新，顯示檔案的變更者和變更時間。

查看變更記錄

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

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

查看程式碼審查

如果是 Gerrit 程式碼審查，可以直接從「變更記錄」窗格開啟這項工具。

如要查看檔案的程式碼審查：

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

Gerrit 程式碼審查工具會在新的瀏覽器視窗中開啟。

開啟特定修訂版本的檔案

如要在特定修訂版本開啟檔案，請按照下列步驟操作：

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

比較檔案與不同修訂版本

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

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

檔案窗格會更新，並列顯示這兩個檔案的比較結果。兩個提交內容中較舊的版本一律會顯示在左側。

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

如要變更任一檔案，請將游標懸停在「變更記錄」窗格中的修訂版本上。然後按一下「左」或「右」按鈕，在差異的左側或右側開啟提交。

瀏覽交叉參照

您也可以使用交叉參照瀏覽來源存放區。這些參照會自動顯示為指定來源檔案中的超連結。

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

注意：如果「交叉參考」顯示為灰色，表示該檔案不提供交叉參考資料。

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

• 「定義」部分，列出定義參照的檔案
• 「參考資料」部分，列出參考資料也出現在其中的檔案

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

您可以使用「交叉參照」窗格繼續瀏覽交叉參照，就像在「檔案」窗格中一樣。此時窗格會顯示階層連結路徑，您可使用該路徑在不同交互參照之間導覽。

搜尋程式碼

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

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

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

foo\.java
"foo.java"

您可以使用下列篩選器來修正搜尋範圍。

其他支援

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