搜尋程式碼集

回報問題 查看原始碼 Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

產品總覽

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」按鈕。
  3. 按一下「DIFF」按鈕。

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

在「變更記錄」窗格中，系統會醒目顯示兩個修訂版本，並在標籤中指出修訂版本顯示在左側還是右側。

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

瀏覽交叉參照

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

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

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

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

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

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

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

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

所有搜尋皆預設使用 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」

其他支援

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