1cd5e13652
Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com> Co-authored-by: Felicity Chapman <felicitymay@github.com> Co-authored-by: Sarah Schneider <sarahs@github.com>
60 lines
3.7 KiB
Markdown
60 lines
3.7 KiB
Markdown
---
|
|
title: Finding files on GitHub
|
|
intro: 'You can search for a file in a repository using the file finder. To search for a file in multiple repositories on {% data variables.product.github %}, use the {% ifversion code-search-upgrade %}[`path` code search qualifier](/search-github/github-code-search/understanding-github-code-search-syntax#path-qualifier){% else %}[`filename` code search qualifier](/search-github/searching-on-github/searching-code#search-by-filename){% endif %}.'
|
|
redirect_from:
|
|
- /articles/finding-files-on-github
|
|
- /github/searching-for-information-on-github/finding-files-on-github
|
|
- /github/searching-for-information-on-github/searching-on-github/finding-files-on-github
|
|
versions:
|
|
fpt: '*'
|
|
ghes: '*'
|
|
ghec: '*'
|
|
topics:
|
|
- GitHub search
|
|
---
|
|
|
|
> [!TIP]
|
|
> * By default, file finder results exclude some directories like `build`, `log`, `tmp`, and `vendor`. To search for files in these directories, {% ifversion code-search-upgrade %}use the [`path` code search qualifier](/search-github/github-code-search/understanding-github-code-search-syntax#path-qualifier){% else %}use the [`filename` code search qualifier](/search-github/searching-on-github/searching-code#search-by-filename){% endif %}. Alternatively, you can customize which directories are excluded by default [using a `.gitattributes` file](#customizing-excluded-files).
|
|
> * You can also open the file finder by pressing `t` on your keyboard. For more information, see [AUTOTITLE](/get-started/accessibility/keyboard-shortcuts).
|
|
|
|
## Using the file finder
|
|
|
|
{% data reusables.repositories.navigate-to-repo %}
|
|
1. In the “Go to file” search bar, type the name of the file or directory you'd like to find.
|
|
|
|
1. Alternatively, if there is no "Go to file" search bar, click **Go to file**, then type the name of the file or directory you'd like to find.
|
|
|
|
1. In the list of results, click the file or directory you wanted to find. You can view the file path for a directory or file below each search result.
|
|
|
|
## Customizing excluded files
|
|
|
|
By default, file finder results do not include files in the following directories if they exist at your repository root:
|
|
|
|
* `.git`
|
|
* `.hg`
|
|
* `.sass-cache`
|
|
* `.svn`
|
|
* `build`
|
|
* `dot_git`
|
|
* `log`
|
|
* `tmp`
|
|
* `vendor`
|
|
|
|
You can override these default exclusions using a `.gitattributes` file.
|
|
|
|
To do this, create or update a file called `.gitattributes` in your repository root, setting the [`linguist-generated`](https://github.com/github-linguist/linguist/blob/main/docs/overrides.md) attribute to `false` for each directory that should be included in file finder results.
|
|
|
|
For example, the following `.gitattributes` file would cause files in the `build/` directory to be available to the file finder:
|
|
|
|
```text
|
|
build/** linguist-generated=false
|
|
```
|
|
|
|
Note that this override requires the use of the recursive glob pattern (`**`). For more information, see [pattern format](https://git-scm.com/docs/gitignore#_pattern_format) in the Git documentation. More complex overrides of subdirectories within excluded-by-default directories are not supported.
|
|
|
|
## Further reading
|
|
|
|
* [AUTOTITLE](/search-github/getting-started-with-searching-on-github/about-searching-on-github)
|
|
* [AUTOTITLE](/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github)
|
|
* [`.gitattributes`](https://git-scm.com/docs/gitattributes) in the Git documentation
|