本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
搜尋程式碼、問題、專案和使用者 CodeCatalyst
使用中的搜尋列或專用的搜尋結果視窗 CodeCatalyst 來搜尋程式碼、問題、專案和使用者 CodeCatalyst。
您可以在搜尋列中輸入名稱、描述和狀態等查詢,來尋找空間和專案中的資源。您也可以使用搜尋查詢語言來縮小搜尋查詢。
若要搜尋
-
在頂端導覽列的搜尋列中,輸入搜尋查詢。
-
(選擇性) 使用的搜尋查詢語言 CodeCatalyst來縮小搜尋查詢。如需詳細資訊,請參閱 精簡您的搜尋查詢。
-
執行以下任意一項:
-
若要搜尋目前所在專案內的資源,請選擇 [此專案]。
-
若要搜尋您目前所在空間中的所有專案中的資源,請選擇此空間。
-
-
執行下列任一項作業,在專用的搜尋結果視窗中檢視搜尋結果:
-
在快速搜索結果窗口的底部,選擇「查看所有結果(在計划名稱中)」|「空格名稱」以查看所有搜索結果。
-
按 Enter 鍵可檢視所有搜尋結果。
-
提示
在提取要求註解或說明中,或在問題註解或說明中,使用 @符號後面加上顯示名稱或使用者名稱,提及其他專案使用者。您也可以使用 @符號後面接問題或代碼檔案的名稱來連結到問題或程式碼檔等資源。
精簡您的搜尋查詢
如果您在搜尋後找不到您要尋找的內容,您可以使用專門的查詢語言 CodeCatalyst來縮小搜尋範圍。個別欄位沒有字元限制,但整體查詢的限制為 1,024 個字元。
按類型精煉
若要將搜尋範圍縮小為特定類型的資訊,請包含
在搜尋中,其中type:result-type
結果類型
為code
issue
、project
、或user
。
範例:
按字段精煉
若要將搜尋範圍縮小為特定欄位,請
在搜尋中加入field-name:query
欄位名稱
為title
username
project
description
、、、等等,查詢
是您要搜尋的文字。如需欄位清單,請參閱可搜尋欄位參考。您可以使用括號搜尋多個查詢。
範例:
-
title:bug
— 顯示標題包含「bug」的結果。 -
username:John
— 顯示使用者名稱包含「John」的結果。 -
project:DataFeeder
— 在專案「DataFeeder」中顯示結果。查詢不區分大小寫。 -
description:overview
— 顯示描述包含「概述」的結果。
使用布林運算子精簡
若要指定搜尋片語的限制,您可以使用布林運算子AND
OR
、、和NOT
。如果您列出多個片語,默認情況OR
下將它們 CodeCatalyst連接起來。您可以使用括號將搜尋詞組成群組。
-
exception AND type:code
— 僅顯示「異常」的代碼結果。 -
path:README.md AND repo:ServerlessAPI
— 顯示具有「Readme.md」路徑的結果,其中存儲庫被命名為「無服務器 API」。 -
buildspec.yml AND (repo:ServerlessAPI OR ServerlessWebApp)
-顯示「構建規格 .yml」的結果,其中存儲庫是「無服務器 API」或「」。ServerlessWebApp -
path:java NOT (path:py OR path:ts)
— 顯示路徑包含「java」但不包含「py」或「ts」的結果。
按項目精煉
若要將搜尋範圍縮小為特定專案,請包含
在您的搜尋中,其中 project:name AND query
name
是您要搜尋的專案,而查詢
是您要搜尋的內容。
-
project:name AND query
— 顯示路徑包含查詢和專案名稱的結果。
使用搜尋時的考量
延遲內容更新 — 內容更新 (例如名稱變更或重新指派問題) 可能需要數分鐘的時間才會反映在搜尋結果中。大型更新 (例如程式碼庫移轉) 可能需要較長的時間才會顯示在搜尋結果中。
逸出特殊字元 — 下列特殊字元需要在搜尋查詢中特別考量:+ - & & || ! ( ) { } [ ]
^ " ~ * ? : \
特殊字元不會影響查詢,您必須移除它們或逸出它們。若要逸出字元,請在字元前面加上反斜線 (\)。例如,搜尋查詢 [功能] 應為 [特徵] 或 [功能\]。
縮小搜尋範圍 — 搜尋不區分大小寫。以全部小寫字母搜尋可防止您的查詢在大小寫變更時分割文字。例如,若要查詢MyService
和僅查詢MyService
,請考慮查詢myservice
以避免僅包含my
或的結果service
。
搜索默認情況下將單詞和單詞的部分與或明智的結合聯接起來。例如,new function
可以傳回包含new
和function
且只有new
或的結果function
。為了避免後者,請將多個單詞與AND
. 例如,您可以搜尋new AND function
。
預設分支 — 搜尋只會傳回來源儲存庫預設分支上最新提交的程式碼結果。要查找其他分支或提交上的代碼,請考慮在本地克隆存儲庫,在開發環境中打開分支,或在 CodeCatalyst UI 中查看分支和詳細信息。更改默認分支會導致更新通過搜索發現的文件。如需詳細資訊,請參閱 管理儲存庫的預設分支。
重要
CodeCatalyst 不支持檢測鏈接存儲庫的默認分支中的更改。若要變更連結存放庫的預設分支,您必須先將其與之取消連結 CodeCatalyst,變更預設分支,然後再次連結它。如需詳細資訊,請參閱 在 CodeCatalyst 中連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案。
最佳作法是在連結存放庫之前,務必確定您擁有最新版本的擴充功能。
可搜尋欄位參考
CodeCatalyst 當您輸入搜尋查詢時,會搜尋下列欄位。別名是您可以用來參考進階查詢語言中欄位的另一個名稱。
欄位 | 別名 | 描述 |
---|---|---|
分行名稱 |
分支 |
代碼文件所在的分支名稱。 |
code |
N/A |
有關代碼內容的信息,以代碼片段的形式表示與搜索匹配的源代碼的部分。 |
同意 |
N/A |
返回代碼最後更新的提交的提交 ID。可能是也可能不是在中指定的分支名稱提示的提交 ID。 |
提交留言 |
N/A |
上次更新程式碼所在之提交的提交訊息。可能是也可能不是在中指定的分支名稱提示處的提交消息。 |
filePath |
路徑 |
此代碼文件的文件路徑。 |
lastUpdatedBy |
N/A |
CodeCatalyst 上次更新代碼 FILE 的用戶。如果使用者名稱不可用,這個值將會是 Git 設定中設定的使用者的電子郵件地址。 |
lastUpdatedBy識別碼 |
N/A |
上次更新代碼的系統生成的用戶的唯一 ID。如果使用者 ID 無法使用,則此值可能是使用者的電子郵件地址。 |
lastUpdatedTime |
N/A |
上次使用包含代碼的提交更新搜尋資料的時間 (以協調世界時間 (UTC) 時間戳記表示)。 |
projectId |
N/A |
系統產生的專案唯一 ID。 |
projectName |
專案名稱,專案 |
顯示項目的名稱,該項目包含已提交代碼 FILE 的源存儲庫。 |
儲存庫 |
RepoID |
系統產生的來源儲存庫的唯一 ID。 |
儲存庫名稱 |
儲存庫, 回購 |
已提交程式碼欄位的來源儲存庫的顯示名稱。 |
欄位 | 別名 | 描述 |
---|---|---|
受讓人 |
指定 |
指派給問題之使用者的系統產生的唯一 ID。 |
受讓人 |
受讓人 |
指定給問題的使用者的使用者名稱。 |
創建 |
N/A |
顯示建立問題的使用者名稱。 |
createdById |
N/A |
由系統產生的建立問題之使用者的唯一 ID。 |
創建時間 |
N/A |
建立問題的時間 (以國際標準時間 (UTC) 時間戳記表示)。 |
description |
N/A |
問題的描述。 |
是封存 |
archived |
Boolean 值,指出是否要在封存狀態下建立問題。 |
被封鎖 |
已封鎖 |
Boolean 值,指出問題是否標記為已封鎖。 |
標籤 |
標籤 |
系統針對問題產生的標籤唯一 ID。 |
lastUpdatedBy |
N/A |
顯示上次更新問題的使用者名稱。 |
lastUpdatedBy識別碼 |
N/A |
系統產生的上次更新問題之使用者的唯一 ID。 |
lastUpdatedTime |
N/A |
上次更新問題的時間 (以國際標準時間 (UTC) 時間戳記表示)。 |
priority |
N/A |
問題的優先順序 (如果已指派)。 |
projectId |
N/A |
系統產生的專案唯一 ID。 |
projectName |
專案名稱,專案 |
可以發現此問題的項目。 |
短時間 |
N/A |
縮短、自動遞增的問題識別碼。 |
status |
N/A |
問題的狀態,指出問題是否在待處理或列中。 |
雕像 |
N/A |
狀態的系統識別碼。 |
標題 |
N/A |
問題的標題。 |
欄位 | 別名 | 描述 |
---|---|---|
description |
N/A |
專案的描述。 |
lastUpdatedTime |
N/A |
上次更新專案中繼資料的時間 (以協調世界時間 (UTC) 時間戳記表示)。 |
projectName |
project |
空間中專案的名稱。 |
專案路徑 |
N/A |
專案的 URL 可傳遞名稱,在專案建立期間解除。用於需要專案名稱的 URL。 |
欄位 | 別名 | 描述 |
---|---|---|
displayName |
N/A |
中用於使用者的名稱 CodeCatalyst。顯示名稱不是唯一的。 |
|
N/A |
使用者的電子郵件地址。 |
lastUpdatedTime |
N/A |
上次更新使用者中繼資料的時間 (以協調世界時間 (UTC) 時間戳記表示)。 |
使用者名稱 |
使用者名稱 |
使用者在註冊時選擇的使用者名稱 CodeCatalyst。與顯示名稱不同,使用者名稱無法變更。 |