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