搜尋程式碼集

回報問題 查看原始碼 。 。 。 。 夜間7.3 。 。 7.2 。 。 7.1 。 。 7.0 。 。 6.5

產品總覽

Bazel 的程式碼搜尋與來源瀏覽介面 是一種網頁式工具,用於瀏覽 Bazel 原始碼存放區。你可以 請使用這些功能瀏覽不同的存放區、分支版本 檔案。你也可以查看歷史記錄、差異和問題資訊。

開始使用

如要存取程式碼搜尋和原始碼瀏覽介面,請開啟 https://source.bazel.build

主畫面會隨即顯示。此畫麵包含以下元件:

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

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

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

使用存放區

開啟存放區

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

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

切換存放區

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

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

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

  1. 從存放區檢視畫面選取檔案。
  2. 在導覽標記工具列中,開啟「分支版本」選單。
  3. 在顯示的子選單中,按一下 [Commit] (修訂版本)。
  4. 選取要查看的修訂版本。

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

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

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

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

使用檔案

從主畫面選取存放區時,畫面會變更為顯示 該存放區的檢視畫面如果 README 檔案存在,其內容會顯示在 檔案窗格 (位於畫面右側)。如果 畫面上會顯示存放區的檔案和資料夾畫面左側是一棵樹 存放區檔案與資料夾的檢視畫面您可以使用這個樹狀結構瀏覽及 開啟特定檔案。

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

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

開啟檔案

如要開啟檔案,請前往檔案目錄並選取該檔案。CANNOT TRANSLATE 存放區會更新,在檔案窗格中顯示檔案內容,且 在樹狀結構的存放區中

查看檔案變更

如何查看檔案變更:

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

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

查看變更記錄

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

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

查看程式碼審查

若要審查 Gerrit 程式碼,您可以直接在「變更記錄」窗格中開啟這項工具。

如要查看檔案的程式碼審查情形:

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

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

在特定修訂版本開啟檔案

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

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

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

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

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

檔案窗格會更新,顯示兩者並列比較 檔案。兩個修訂版本中最舊的修訂版本一律位於左側。

「變更記錄」窗格的兩個修訂版本均以醒目方式顯示,標籤則代表 (在左側或右側顯示修訂版本)。

若要變更任一檔案,請將滑鼠遊標懸停在「變更記錄」窗格中的修訂版本。接著: 按一下「Left」或「Right」按鈕,即可在 調整差異的左側或右側

瀏覽交叉參考資料

另一種瀏覽來源存放區的方法是使用十字 參照。這些參照會自動以超連結形式顯示在 來源檔案。

如要輕鬆識別交叉參考資料,請按一下「交叉參考資料」。 。這個選項會在所有項目下方顯示底線 檔案中的交互參照

注意:如果「跨參照」顯示為灰色,表示 無法交叉參照。

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

  • 定義區段,會列出用來 參照
  • 「參考資料」部分,會列出要在其中參照的檔案 出現

這兩個部分都會顯示檔案名稱,以及一行或資料 包含參照的物件。如要透過「交叉參照」窗格開啟檔案, 按一下行號項目檔案會顯示在窗格的新部分 可以繼續瀏覽檔案,同時保留原始檔案 。

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

如要搜尋特定檔案或程式碼片段,請使用 位於畫面頂端。系統一律會根據預設分支版本進行搜尋。

所有搜尋都會使用 RE2 規則運算式 根據預設。如果您不想使用規則運算式,請擴大搜尋範圍 並放在雙引號中 ( " )。

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

foo\.java
"foo.java"

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

篩選 其他選項 說明 範例
lang: 語言: 依照檔案語言執行完全比對。 lang:java 測試
檔案: filepath:
路徑:
f:
case:yes 使搜尋區分大小寫。根據預設,搜尋時不區分大小寫。 Case:yes Hello World
class: 搜尋類別名稱。 class:MainClass
function: func: 搜尋函式名稱。 function:print
- 從搜尋中排除字詞。 哈囉,世界
\ 逸出特殊字元,例如 .、\ 或 (。 跑步\(\)
「[term]」 執行常值搜尋。 "class:main"

其他支援

如要回報問題,請按一下頂端顯示的「提供意見」按鈕 並在畫面中顯示的表單中輸入您的意見。