Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 CodeCatalyst 中搜尋程式碼、問題、專案和使用者
<a name="search"></a>

使用 CodeCatalyst 中的搜尋列或專用搜尋結果視窗來搜尋程式碼、問題、專案和使用者 CodeCatalyst。

您可以在搜尋列中輸入名稱、描述和狀態等查詢，以尋找空間和專案的資源。您也可以使用搜尋查詢語言來精簡您的搜尋查詢。

**Topics**
+ [精簡您的搜尋查詢](#search-query-language-examples)
+ [使用搜尋時的考量](#search-tips-troubleshooting)
+ [可搜尋欄位參考](#search-query-language-searchable-fields)

**搜尋**

1. 在頂端導覽列的搜尋列中，輸入搜尋查詢。

1. （選用） 使用 CodeCatalyst 的搜尋查詢語言來精簡您的搜尋查詢。如需詳細資訊，請參閱[精簡您的搜尋查詢](#search-query-language-examples)。

1. 執行以下任意一項：
   + 若要搜尋您目前所在專案內的資源，請選擇**此專案**。
   + 若要搜尋您目前所在空間中所有專案內的資源，請選擇**此空間**。

1. 在專用搜尋結果視窗中，執行下列其中一項來檢視搜尋結果：
   + 在快速搜尋結果視窗底部，選擇在 **project-name \$1 space-name 中檢視所有結果**，以檢視所有搜尋結果。
   + 按下 **Enter** 以檢視所有搜尋結果。

**提示**  
在提取請求註解或描述中，或在問題註解或描述中提及其他專案使用者，方法是使用 @ 符號，後面接著其顯示名稱或使用者名稱。您也可以使用 @ 符號，後面接著問題或程式碼檔案的名稱，來連結至問題或程式碼檔案等資源。

## 精簡您的搜尋查詢
<a name="search-query-language-examples"></a>

如果您在搜尋後找不到要尋找的內容，您可以使用 CodeCatalyst 的專業查詢語言來精簡搜尋。個別欄位沒有字元限制，但整體查詢的限制為 1，024 個字元。

**Topics**
+ [依類型精簡](#search-query-language-type-search)
+ [依欄位精簡](#search-query-language-field-search)
+ [使用布林運算子進行精簡](#search-query-language-boolean-search)
+ [依專案精簡](#search-query-language-project-search)

### 依類型精簡
<a name="search-query-language-type-search"></a>

若要將搜尋範圍精簡為特定類型的資訊，請在搜尋`type:result-type`中包含 ，其中*結果類型*為 `code`、`project`、 `issue`或 `user` 。

範例：
+ `type:code AND java` – 在包含「java」的程式碼相關欄位中顯示程式碼結果。

  如需詳細資訊，請參閱[程式碼欄位](#search-query-language-type-code)。
+ `type:issue AND Bug` – 在包含「錯誤」的問題相關欄位中顯示問題結果。

  如需詳細資訊，請參閱[問題欄位](#search-query-language-type-issue)。
+ `type:user AND MaryMajor` – 在包含「MaryMajor」的使用者相關欄位中顯示使用者結果。

  如需詳細資訊，請參閱[使用者欄位](#search-query-language-type-user)。
+ `type:project AND Datafeeder` – 顯示包含 "Datafeeder" 的專案結果。

  如需詳細資訊，請參閱[專案欄位](#search-query-language-type-project)。

### 依欄位精簡
<a name="search-query-language-field-search"></a>

若要將搜尋範圍精簡為特定欄位，請在搜尋`field-name:query`中包含 ，其中 *field-name* 為 `title`、`description`、、 等，而 *query* `username` `project`是您搜尋的文字。如需欄位清單，請參閱 [可搜尋欄位參考](#search-query-language-searchable-fields)。您可以使用括號搜尋多個查詢。

範例：
+ `title:bug` – 顯示標題包含「bug」的結果。
+ `username:John` – 顯示使用者名稱包含 “John” 的結果。
+ `project:DataFeeder` – 顯示專案「DataFeeder」中的結果。查詢不區分大小寫。
+ `description:overview` – 顯示描述包含「概觀」的結果。

### 使用布林運算子進行精簡
<a name="search-query-language-boolean-search"></a>

若要指定搜尋片語的限制，您可以使用布林值運算子 `AND`、 `OR`和 `NOT`。如果您列出多個片語，根據`OR`預設，CodeCatalyst 會將它們與 聯結。您可以使用括號將搜尋片語分組。
+ `exception AND type:code` – 僅顯示「例外狀況」的程式碼結果。
+ `path:README.md AND repo:ServerlessAPI` – 顯示路徑的結果，其中 README.md 儲存庫名為「ServerlessAPI」。
+ `buildspec.yml AND (repo:ServerlessAPI OR ServerlessWebApp)` – 顯示 "buildspec.yml" 的結果，其中儲存庫為 "ServerlessAPI" 或 "ServerlessWebApp"。
+ `path:java NOT (path:py OR path:ts)` – 顯示路徑包含「java」但非「py」或「ts」的結果。

### 依專案精簡
<a name="search-query-language-project-search"></a>

若要將搜尋範圍精簡為特定專案，請在搜尋`project:name AND query`中包含 ，其中*名稱*是您要搜尋的專案，而*查詢*是您要搜尋的內容。
+ `project:name AND query` – 顯示路徑包含查詢和專案名稱的結果。

## 使用搜尋時的考量
<a name="search-tips-troubleshooting"></a>

**延遲的內容更新** – 內容更新可能需要幾分鐘的時間，例如名稱變更或問題重新指派，才會反映在搜尋結果中。大型更新，例如程式碼基底遷移，可能需要更長的時間才會出現在搜尋結果中。

**逸出特殊字元** – 下列特殊字元需要在搜尋查詢中特別考量：`+ - & & || ! ( ) { } [ ] ^ " ~ * ? : \`。特殊字元不會影響查詢，您必須將其移除或逸出。若要逸出角色，請在角色前面新增反斜線 (\$1)。例如，搜尋查詢 【特徵】 應該是特徵或 \$1【特徵\$1】。

**縮小搜尋範圍** – 搜尋不區分大小寫。在所有小寫中搜尋可防止您的查詢在案例變更時分割單字。例如，若要查詢 `MyService`和僅查詢 `MyService`，請考慮查詢 `myservice` 以避免僅包含 `my`或 的結果`service`。

根據預設，搜尋會使用 OR-wise 結合來聯結單字和單字的部分。例如， `new function`可能會傳回包含 `new`和 的結果`function`，以及僅包含 `new`或 的結果`function`。若要避免後者，請結合多個單字與 `AND`。例如，您可以搜尋 `new AND function`。

**預設分支** – 搜尋只會傳回來源儲存庫預設分支上最新遞交的程式碼結果。若要尋找其他分支或遞交的程式碼，請考慮[在本機複製儲存庫](source-repositories-clone.md)、[在開發環境中開啟分支](devenvironment-create.md)，或在 [ CodeCatalyst UI 中檢視分支和詳細資訊](source-branches-view.md)。變更預設分支會導致檔案更新，可透過搜尋探索。如需詳細資訊，請參閱[管理儲存庫的預設分支](source-branches-default-branch.md)。

**重要**  
CodeCatalyst 不支援偵測連結儲存庫的預設分支中的變更。若要變更連結儲存庫的預設分支，您必須先將其從 CodeCatalyst 取消連結、變更預設分支，然後再次連結。如需詳細資訊，請參閱[在 CodeCatalyst 中連結 GitHub 儲存庫、Bitbucket 儲存庫、GitLab 專案儲存庫和 Jira 專案](extensions-link.md)。  
最佳實務是，在連結儲存庫之前，請務必確保您擁有最新版本的延伸模組。

## 可搜尋欄位參考
<a name="search-query-language-searchable-fields"></a>

當您輸入搜尋查詢時，CodeCatalyst 會搜尋下列欄位。別名是另一個名稱，您可以用來參考進階查詢語言中的 欄位。

### 程式碼欄位
<a name="search-query-language-type-code"></a>


| 欄位 | 別名 | 描述 | 
| --- | --- | --- | 
|  branchName  |  分支  |  程式碼檔案所在的分支名稱。  | 
|  code  |  N/A  |  程式碼片段形式的程式碼內容資訊，指出符合搜尋的部分原始程式碼。  | 
|  commitId  |  N/A  |  遞交的遞交 ID，其中傳回的程式碼檔案上次更新。不一定是 中指定分支名稱頂端的遞交 ID`branchName`。  | 
|  commitMessage  |  N/A  |  遞交的遞交訊息，其中的程式碼檔案上次更新。不一定是 中指定分支名稱頂端的遞交訊息`branchName`。如果未提供遞交訊息，則此值將為空字串。  | 
|  filePath  |  路徑  |  此程式碼檔案的檔案路徑。  | 
|  lastUpdatedBy  | N/A |  上次更新程式碼檔案的 CodeCatalyst 使用者。如果使用者名稱不可用，此值將是 Git 組態檔案中設定的使用者電子郵件地址。  | 
|  lastUpdatedById  |  N/A  |  系統產生的唯一使用者 ID，上次更新程式碼檔案。如果使用者 ID 不可用，則此值可能是使用者的電子郵件地址。  | 
|  lastUpdatedTime  |  N/A  |  上次使用包含程式碼檔案的遞交更新搜尋資料的時間 （以國際標準時間 (UTC) 時間戳記表示）。  | 
|  projectId  |  N/A  |  系統產生的專案唯一 ID。  | 
|  projectName  |  projectNames、專案  |  顯示包含已遞交程式碼檔案之來源儲存庫的專案名稱。  | 
|  repositoryId  |  repoId  |  系統產生的來源儲存庫唯一 ID。  | 
|  repositoryName  |  儲存庫、儲存庫  |  顯示已遞交程式碼檔案的來源儲存庫名稱。  | 

### 問題欄位
<a name="search-query-language-type-issue"></a>


| 欄位 | 別名 | 描述 | 
| --- | --- | --- | 
|  assigneeIds  |  assigneeId  |  系統為指派給問題的使用者產生的唯一 IDs。  | 
|  被指派者  |  被指派者  |  指派給問題的使用者名稱。  | 
|  createdBy  |  N/A  |  顯示建立問題的使用者名稱。  | 
|  createdById  |  N/A  |  系統產生的唯一 ID 是建立問題的使用者。  | 
|  createdTime  |  N/A  |  問題建立的時間 （以國際標準時間 (UTC) 時間戳記表示）。  | 
|  description  |  N/A  |  問題的描述。  | 
|  isArchived  |  archived  |  布林值，指出是否要在封存狀態下建立問題。  | 
|  isBlocked  |  已封鎖  |  指出問題是否標示為已封鎖的布林值。  | 
|  labelIds  |  labelId  |  系統為問題產生的標籤唯一 IDs。  | 
|  lastUpdatedBy  |  N/A  |  顯示上次更新問題的使用名稱。  | 
|  lastUpdatedById  |  N/A  |  系統為上次更新問題的使用者產生的唯一 ID。  | 
|  lastUpdatedTime  |  N/A  |  上次更新問題的時間 （以國際標準時間 (UTC) 時間戳記表示）。  | 
|  priority  |  N/A  |  如果已指派問題，則為問題的優先順序。  | 
|  projectId  |  N/A  |  系統產生的專案唯一 ID。  | 
|  projectName  |  projectNames、專案  |  可找到此問題的專案。  | 
|  shortId  |  N/A  |  縮短問題的自動遞增識別符。  | 
|  status  |  N/A  |  指出問題是否在待辦項目或機載資料欄的問題狀態。  | 
|  statusId  |  N/A  |  狀態的系統識別符。  | 
|  標題  |  N/A  |  問題的標題。  | 

### 專案欄位
<a name="search-query-language-type-project"></a>


| 欄位 | 別名 | 描述 | 
| --- | --- | --- | 
|  description  |  N/A  |  專案的描述。  | 
|  lastUpdatedTime  |  N/A  |  專案中繼資料上次更新的時間 （以國際標準時間 (UTC) 時間戳記表示）。  | 
|  projectName  |  project  |  空間中的專案名稱。  | 
|  projectPath  |  N/A  |  專案的 URL 可路由名稱，在專案建立期間定義。用於需要專案名稱的 URLs。  | 

### 使用者欄位
<a name="search-query-language-type-user"></a>


| 欄位 | 別名 | 描述 | 
| --- | --- | --- | 
|  displayName  |  N/A  |  CodeCatalyst 中用於使用者的名稱。顯示名稱不是唯一的。  | 
|  email  |  N/A  |  使用者的電子郵件地址。  | 
|  lastUpdatedTime  |  N/A  |  使用者中繼資料上次更新的時間 （以國際標準時間 (UTC) 時間戳記表示）。  | 
|  使用者名稱  |  使用者名稱  |  使用者註冊 CodeCatalyst 時所選擇的使用者名稱。與顯示名稱不同，使用者名稱無法變更。  |