# 在GitHub上查找文件

您可以使用文件查找器在仓库中搜索文件。 若要在 GitHub 上搜索多个存储库中的文件，请使用 path 代码搜索限定符。

> \[!TIP]
>
> * 默认情况下，文件查找器结果将排除某些目录，例如 `build`、`log`、`tmp` 和 `vendor`。 若要搜索这些目录中的文件，使用 [`path` 代码搜索限定符](/zh/search-github/github-code-search/understanding-github-code-search-syntax#path-qualifier)。 或者，默认情况下，可以[使用文件 `.gitattributes`](#customizing-excluded-files) 文件自定义要排除的目录。
> * 按键盘上的 `t` 键也可以打开文件查找器。 有关详细信息，请参阅“[键盘快捷方式](/zh/get-started/accessibility/keyboard-shortcuts)”。

## 使用文件查找器

1. 在 GitHub 上，导航到存储库的主页面。
2. 在“转到文件”搜索栏中，键入要查找的文件或目录的名称。

   ```
          ![存储库的主视图的屏幕截图。 标记为“转到文件”的搜索栏以深橙色标出。](/assets/images/help/repository/repository-main-page-go-to-file.png)
   ```
3. 或者，如果没有“转到文件”搜索栏，请单击“**转到文件**”，然后键入要查找的文件或目录的名称。

   ```
          ![存储库的主视图的屏幕截图。 “转到文件”按钮以深橙色框出。](/assets/images/help/repository/repository-main-page-go-to-file-no-search-bar.png)
   ```
4. 在结果列表中，单击要查找的文件或目录。 在每个搜索结果下方可以查看目录或文件的文件路径。

## 自定义排除的文件

默认情况下，文件查找器结果不包括以下目录中的文件：

* `.git`
* `.hg`
* `.sass-cache`
* `.svn`
* `build`
* `dot_git`
* `log`
* `tmp`
* `vendor`

可以使用 `.gitattributes` 文件替代这些默认排除项。

为此，请在存储库根路径中创建或更新名为 `.gitattributes` 的文件，将应包含在文件查找器结果中的每个目录的 [`linguist-generated`](https://github.com/github-linguist/linguist/blob/main/docs/overrides.md) 属性设置为 `false`。

例如，以下 `.gitattributes` 文件会导致 `build/` 目录中的文件可供文件查找器使用：

```text
build/** linguist-generated=false
```

请注意，此替代需要使用递归 glob 模式 (`**`)。 有关详细信息，请参阅 Git 文档中的[模式格式](https://git-scm.com/docs/gitignore#_pattern_format)。 不支持对默认排除目录中的子目录进行更复杂的替代。

## 其他阅读材料

* [关于在GitHub上的搜索](/zh/search-github/getting-started-with-searching-on-github/about-searching-on-github)
* [自定义更改的文件在GitHub上的显示方式](/zh/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github)
* Git 文档中的 [`.gitattributes`](https://git-scm.com/docs/gitattributes)