本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
在中搜索代码、问题、项目和用户 CodeCatalyst
使用中的搜索栏或专用的搜索结果窗口 CodeCatalyst 来搜索代码、问题、项目和用户 CodeCatalyst。
通过在搜索栏中输入姓名、描述和状态等查询,即可在空间和项目中查找资源。您也可以使用搜索查询语言来优化搜索查询。
要搜寻
-
在顶部导航栏的搜索栏中,输入搜索查询。
-
(可选)使用 CodeCatalyst搜索查询语言优化您的搜索查询。有关更多信息,请参阅 完善您的搜索查询。
-
请执行以下操作之一:
-
要在您当前所在的项目中搜索资源,请选择此项目。
-
要在您当前所在空间的所有项目中搜索资源,请选择此空间。
-
-
通过执行以下任一操作,在专用的搜索结果窗口中查看搜索结果:
-
在快速搜索结果窗口的底部,选择在项目名称中查看所有结果 | space-name 以查看所有搜索结果。
-
按 Enter 键查看所有搜索结果。
-
提示
在拉取请求评论或描述中,或者在问题评论或描述中提及其他项目用户,方法是使用 @ 符号后面加上他们的显示名称或用户名。您还可以使用 @ 符号和议题或代码文件名称来链接到议题或代码文件等资源。
完善您的搜索查询
如果搜索后找不到要查找的内容,则可以使用专门 CodeCatalyst的查询语言来优化搜索。单个字段没有字符限制,但整个查询的字符限制为 1,024 个字符。
按类型细化
要将搜索范围缩小到特定类型的信息,请在搜索
中加入,其中type:result-type
结果类型
为code
、issue
project
、或。user
示例:
按领域细化
要将搜索范围缩小到特定字段,请在搜索
中加入,其中 field-name:query
field-name
为title
username
project
、description
、、等,query
是您要搜索的文本。有关字段的列表,请参阅可搜索字段参考。您可以使用圆括号搜索多个查询。
示例:
-
title: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” 的路径的结果,其中存储库名为 “ServerlessAPI”。 -
buildspec.yml AND (repo:ServerlessAPI OR ServerlessWebApp)
— 显示存储库为 “ServerlessAPI” 或 “” 的 “buildspec.yml” 的结果。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
。
默认情况下,搜索使用OR-wise连词连接单词和单词的一部分。例如,new function
可以返回同时包含new
function
和的结果,也可以返回仅包含new
或的结果function
。为避免后者,请将多个单词与合并AND
。例如,您可以搜索new AND function
。
默认分支-搜索将仅返回源存储库默认分支上最新提交的代码结果。要在其他分支或提交上查找代码,可以考虑在本地克隆存储库,在开发环境中打开分支,或者在 CodeCatalyst 用户界面中查看分支和详细信息。更改默认分支会导致更新可通过搜索发现的文件。有关更多信息,请参阅 管理仓库的默认分支。
重要
CodeCatalyst 不支持检测链接仓库的默认分支中的更改。要更改链接存储库的默认分支,必须先取消其与该分支的链接 CodeCatalyst,更改默认分支,然后再次进行链接。有关更多信息,请参阅 在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。
作为最佳实践,在链接存储库之前,请务必确保您拥有最新版本的扩展程序。
可搜索字段参考
CodeCatalyst 当您输入搜索查询时,会搜索以下字段。别名是可用于在高级查询语言中引用该字段的另一个名称。
字段 | 别名 | 描述 |
---|---|---|
分支名称 |
分支 |
代码文件所在分支的名称。 |
代码 |
不适用 |
有关代码内容的信息,以代码片段的形式表示,源代码中与搜索结果相匹配的部分。 |
CommitID |
不适用 |
上次更新返回的代码文件的提交 ID。可能是中指定的分支名称末端的提交 ID,也可能不是。 |
提交消息 |
不适用 |
上次更新代码文件的提交消息。可能是中指定的分支名称末端的提交消息,也可能不是。 |
filePath |
path |
此代码文件的文件路径。 |
lastUpdatedBy |
不适用 |
CodeCatalyst 上次更新代码文件的用户。如果用户名不可用,则此值将是 Git 配置文件中配置的用户的电子邮件地址。 |
lastUpdatedBy我是 |
不适用 |
系统生成的上次更新代码文件的用户的唯一 ID。如果用户 ID 不可用,则此值可能是用户的电子邮件地址。 |
lastUpdatedTime |
不适用 |
上次使用包含代码文件的提交更新搜索数据的时间(采用协调世界时 (UTC) 时间戳)。 |
projectId |
不适用 |
系统生成的项目唯一 ID。 |
projectName |
项目名称,项目 |
显示包含已提交代码文件的源存储库的项目名称。 |
存储库 ID |
RepoID |
系统生成的源存储库的唯一 ID。 |
repositoryName |
存储库、存储库 |
显示提交代码文件的源存储库的名称。 |
字段 | 别名 | 描述 |
---|---|---|
AssigneeID |
AssigneeID |
系统生成的分配给该问题的用户的唯一 ID。 |
受托人 |
受托人 |
分配给议题的用户的用户名。 |
创建者 |
不适用 |
显示创建议题的用户的姓名。 |
createdById |
不适用 |
系统生成的问题创建用户的唯一 ID。 |
CreatedTime |
不适用 |
问题出现的时间(以协调世界时 (UTC) 时间戳为单位)。 |
description |
不适用 |
问题描述。 |
已存档 |
archived |
表示是否在已存档状态下创建议题的布尔值。 |
isBlock |
blocked |
表示问题是否被标记为已阻止的布尔值。 |
LabeLids |
LabeLid |
系统生成的问题标签的唯一 ID。 |
lastUpdatedBy |
不适用 |
显示上次更新问题的用户姓名。 |
lastUpdatedBy我是 |
不适用 |
系统生成的上次更新问题的用户的唯一 ID。 |
lastUpdatedTime |
不适用 |
问题上次更新的时间(以协调世界时 (UTC) 时间戳为单位)。 |
priority |
不适用 |
问题的优先级(如果已分配)。 |
projectId |
不适用 |
系统生成的项目唯一 ID。 |
projectName |
项目名称,项目 |
可以在其中找到此问题的项目。 |
ShortID |
不适用 |
问题的缩短、自动递增的标识符。 |
status |
不适用 |
问题的状态,指示问题是在待办事项中还是在船上专栏中。 |
StatusID |
不适用 |
状态的系统标识符。 |
title |
不适用 |
问题的标题。 |
字段 | 别名 | 描述 |
---|---|---|
description |
不适用 |
项目描述。 |
lastUpdatedTime |
不适用 |
项目元数据上次更新的时间(采用协调世界时 (UTC) 时间戳)。 |
projectName |
项目 |
空间中项目的名称。 |
项目路径 |
不适用 |
项目的 URL 可路由名称,在项目创建过程中定义。用于需要项目名称的 URL。 |
字段 | 别名 | 描述 |
---|---|---|
displayName |
不适用 |
中用于用户的名称 CodeCatalyst。显示名称不是唯一的。 |
|
不适用 |
用户的电子邮件地址。 |
lastUpdatedTime |
不适用 |
上次更新用户元数据的时间(采用协调世界时 (UTC) 时间戳)。 |
userName |
username |
用户在注册时选择的用户名 CodeCatalyst。与显示名称不同,用户名无法更改。 |