{"meta":{"title":"了解搜索语法","intro":"搜索 GitHub时，可以构造与特定数字和字词匹配的查询。","product":"在 GitHub 上搜索","breadcrumbs":[{"href":"/zh/search-github","title":"在 GitHub 上搜索"},{"href":"/zh/search-github/getting-started-with-searching-on-github","title":"从搜索GitHub开始"},{"href":"/zh/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax","title":"了解搜索语法"}],"documentType":"article"},"body":"# 了解搜索语法\n\n搜索 GitHub时，可以构造与特定数字和字词匹配的查询。\n\n> \\[!NOTE]\n> 以下语法适用于非代码搜索。 有关代码搜索语法的详细信息，请参阅 [了解GitHub代码搜索语法](/zh/search-github/github-code-search/understanding-github-code-search-syntax)。\n\n## 查询大于或小于另一个值的值\n\n可以使用 `>`、`>=`、`<` 和 `<=` 搜索大于、大于或等于、小于以及小于或等于另一个值的值。\n\n| 查询 | 示例 |\n| ----------------------------------------------------------------------------------------------------------------------------------------- | -- |\n| >n | |\n| \\*\\* | |\n| [cats stars:>1000](https://github.com/search?utf8=%E2%9C%93\\&q=cats+stars%3A%3E1000\\&type=Repositories)\\*\\* 匹配有超过 1000 个星的具有“cats”一词的存储库。 | |\n| >=n | |\n| \\*\\* | |\n| [cats topics:>=5](https://github.com/search?utf8=%E2%9C%93\\&q=cats+topics%3A%3E%3D5\\&type=Repositories)\\*\\* 匹配有 5 个或以上主题的具有“cats”一词的存储库。 | |\n| <n | |\n| \\*\\* | |\n| [cats size:<10000](https://github.com/search?utf8=%E2%9C%93\\&q=cats+size%3A%3C10000\\&type=Code)\\*\\* 匹配尺寸小于 10 KB 的文件中的具有“cats”一词的代码。 | |\n| <=n | |\n| \\*\\* | |\n| [cats stars:<=50](https://github.com/search?utf8=%E2%9C%93\\&q=cats+stars%3A%3C%3D50\\&type=Repositories)\\*\\* 匹配有 50 或更少个星的具有“cats”一词的存储库。 | |\n\n还可以使用[范围查询](#query-for-values-between-a-range)搜索大于或等于或者小于或等于其他值的值。\n\n| 查询 | 示例 |\n| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |\n| n..\\* | |\n| \\*\\* | |\n| [cats stars:10..\\*](https://github.com/search?utf8=%E2%9C%93\\&q=cats+stars%3A10..*\\&type=Repositories)\\*\\* 等效于 `stars:>=10` 并匹配有 10 或更多个星的具有“cats”一词的存储库。 | |\n| \\*..n | |\n| \\*\\* | |\n| [cats stars:\\*..10](https://github.com/search?utf8=%E2%9C%93\\&q=cats+stars%3A%22*..10%22\\&type=Repositories)\\*\\* 等效于 `stars:<=10` 并匹配有 10 或更少个星的具有“cats”一词的存储库。 | |\n\n## 查询指定范围内的值\n\n使用范围语法 n..n 搜索范围内的值，其中第一个数字 N 是最低值，第二个是最高值。\n\n| 查询 | 示例 |\n| -------------------------------------------------------------------------------------------------------------------------------------------- | -- |\n| n..n | |\n| \\*\\* | |\n| [cats stars:10..50](https://github.com/search?utf8=%E2%9C%93\\&q=cats+stars%3A10..50\\&type=Repositories)\\*\\* 匹配有 10 到 50 个星之间的具有“cats”一词的存储库。 | |\n\n## 查询日期\n\n可以使用 `>`、`>=`、`<`、`<=` 和[范围查询](#query-for-values-between-a-range)搜索早于或晚于另一个日期或属于某个日期范围内的日期。 日期格式必须遵循 [ISO8601](http://en.wikipedia.org/wiki/ISO_8601) 标准，即 `YYYY-MM-DD`（年-月-日）。\n\n| 查询 | 示例 |\n| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |\n| >YYYY-MM-DD | |\n| \\*\\* | |\n| [cats created:>2016-04-29](https://github.com/search?utf8=%E2%9C%93\\&q=cats+created%3A%3E2016-04-29\\&type=Issues)\\*\\* 匹配具有 2016 年 4 月 29 日后创建的“cats”一词的问题。 | |\n| >=YYYY-MM-DD | |\n| \\*\\* | |\n| [cats created:>=2017-04-01](https://github.com/search?utf8=%E2%9C%93\\&q=cats+created%3A%3E%3D2017-04-01\\&type=Issues)\\*\\* 匹配具有 2017 年 4 月 1 日或之后创建的“cats”一词的问题。 | |\n| <YYYY-MM-DD | |\n| \\*\\* | |\n| [cats pushed:<2012-07-05](https://github.com/search?q=cats+pushed%3A%3C2012-07-05\\&type=Repositories\\&utf8=%E2%9C%93)\\*\\* 匹配具有在 2012 年 7 月 5 日之前推送到其中的“cats”一词的存储库。 | |\n| <=YYYY-MM-DD | |\n| \\*\\* | |\n| [cats created:<=2012-07-04](https://github.com/search?utf8=%E2%9C%93\\&q=cats+created%3A%3C%3D2012-07-04\\&type=Issues)\\*\\* 匹配具有 2012 年 7 月 4 日或之前创建的“cats”一词的问题。 | |\n| YYYY-MM-DD..YYYY-MM-DD | |\n| \\*\\* | |\n| [cats pushed:2016-04-30..2016-07-04](https://github.com/search?utf8=%E2%9C%93\\&q=cats+pushed%3A2016-04-30..2016-07-04\\&type=Repositories)\\*\\* 匹配具有在 2016 年 4 月末和 7 月之间推送到其中的“cats”一词的存储库。 | |\n| YYYY-MM-DD..\\* | |\n| \\*\\* | |\n| [cats created:2012-04-30..\\*](https://github.com/search?utf8=%E2%9C%93\\&q=cats+created%3A2012-04-30..*\\&type=Issues)\\*\\* 匹配 2012 年 4 月 30 日或之后创建的包含“cats”一词的问题。 | |\n| \\*..YYYY-MM-DD | |\n| \\*\\* | |\n| [cats created:\\*..2012-07-04](https://github.com/search?utf8=%E2%9C%93\\&q=cats+created%3A*..2012-07-04\\&type=Issues)\\*\\* 匹配 2012 年 7 月 4 日或之前创建的包含“cats”一词的问题。 | |\n\n也可以在日期后添加可选的时间信息 `THH:MM:SS+00:00`，以按小时、分钟和秒进行搜索。 即 `T`，随后是 `HH:MM:SS`（时-分-秒）和 UTC 时差 (`+00:00`)。\n\n| 查询 | 示例 |\n| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |\n| YYYY-MM-DDTHH:MM:SS+00:00 | |\n| \\*\\* | |\n| [cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00](https://github.com/search?utf8=%E2%9C%93\\&q=cats+created%3A2017-01-01T01%3A00%3A00%2B07%3A00..2017-03-01T15%3A30%3A15%2B07%3A00\\&type=Issues)\\*\\* 匹配 2017 年 1 月 1 日凌晨 1 点 （UTC 时差为 `07:00`）和 2017 年 3 月 1 日下午 3 点 （UTC 时差为 `07:00`）之间创建的问题。 | |\n| YYYY-MM-DDTHH:MM:SSZ | |\n| \\*\\* | |\n| [cats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z](https://github.com/search?utf8=%E2%9C%93\\&q=cats+created%3A2016-03-21T14%3A11%3A00Z..2016-04-07T20%3A45%3A00Z\\&type=Issues)\\*\\* 匹配 2016 年 3 月 21 日下午 2:11 和 2016 年 4 月 7 日晚上 8:45 之间创建的问题。 | |\n\n## 排除与限定符匹配的结果\n\n可以通过排除一个或多个子集来缩小搜索结果范围。 若要排除该限定符匹配的所有结果，请在搜索限定符前添加一个前缀 (`-`)。\n\n| 查询 | 示例 |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -- |\n| -QUALIFIER | |\n| \\*\\* | |\n| \\[ | |\n| `cats stars:>10 -language:javascript` | |\n| ]\\([https://github.com/search?q=cats+stars%3A>10+-language%3Ajavascript\\&type=Repositories](https://github.com/search?q=cats+stars%3A>10+-language%3Ajavascript\\&type=Repositories)) | |\n| \\*\\* 匹配包含“cats”一词、拥有超过 10 个星且不是用 JavaScript 编写的存储库。 | |\n| -QUALIFIER | |\n| \\*\\* | |\n| \\[ | |\n| `mentions:defunkt -org:github` | |\n| ]\\() | |\n| \\*\\* 匹配提及未在 GitHub 组织中的存储库的 @defunkt 的问题。 | |\n\n## 排除具有特定关键字的结果\n\n可以使用 `NOT` 语法排除包含特定字词的结果。\n`NOT` 运算符只能用于字符串关键字。 不适用于数字或日期。\n\n| 查询 | 示例 |\n| ---------------------------------------------------------------------------------------------------------------------- | -- |\n| `NOT` | |\n| \\*\\* | |\n| [hello NOT world](https://github.com/search?q=hello+NOT+world\\&type=Repositories)\\*\\* 与包含字词“hello”但不包含字词“world”的存储库匹配。 | |\n\n## 对带有空格的查询使用引号\n\n如果搜索含有空格的查询，您需要用引号将其括起来。 例如：\n\n* [cats NOT \"hello world\"](https://github.com/search?utf8=✓\\&q=cats+NOT+\"hello+world\"\\&type=Repositories) 匹配具有“cats”一词但没有“hello world”一词的存储库。\n* [build label:\"bug fix\"](https://github.com/search?utf8=%E2%9C%93\\&q=build+label%3A%22bug+fix%22\\&type=Issues) 匹配具有标签“bug fix”的包含“build”一词的问题。\n\n## 使用用户名的查询\n\n如果搜索查询包含需要用户名的限定符，例如 `user`、`actor` 或 `assignee`，则可以使用任何有效的用户名来指定特定人员，使用 `@me` 指定当前用户，或使用 `@copilot` 指定 Copilot。\n\n| 查询 | 示例 |\n| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |\n| `QUALIFIER:USERNAME` | |\n| \\[ | |\n| `author:nat` | |\n| ]\\() 匹配由 @nat 创建的提交 | |\n| `QUALIFIER:@me` | |\n| \\[ | |\n| `is:issue assignee:@me` | |\n| ]\\() 匹配分配给查看结果的人员的问题 | |\n| | |\n| `QUALIFIER:@copilot` | |\n| \\[ | |\n| `is:pr reviewed-by:@copilot` | |\n| ]\\() 匹配由 Copilot 审阅的拉取请求。 有关详细信息，请参阅“[使用 GitHub Copilot 代码审查](/zh/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review)”。 | |\n| | |\n\n`@me`\n或 `@copilot` 只能与限定符一起使用，不能单独用作搜索词，例如 `@me main.workflow`。"}