# Ignorar arquivos

Você pode configurar o Git para ignorar arquivos dos quais você não deseja fazer o check-in para GitHub.

## Configurar arquivos ignorados para um único repositório

Você pode criar um arquivo `.gitignore` no diretório raiz do repositório para informar o Git de quais arquivos e diretórios devem ser ignorados durante um commit.
Para compartilhar as regras de ignorar com outros usuários que clonam o repositório, faça o commit do arquivo `.gitignore` em seu repositório.

GitHub mantém uma lista oficial de arquivos `.gitignore` recomendados para muitos sistemas operacionais populares, ambientes e idiomas no repositório público "github/gitignore". Use também o gitignore.io para criar um arquivo `.gitignore` para seu sistema operacional, sua linguagem de programação ou seu IDE. Para obter mais informações, consulte [github/gitignore](https://github.com/github/gitignore) e o site [gitignore.io](https://www.gitignore.io/).

1. Abra <span class="platform-mac">Terminal</span><span class="platform-linux">Terminal</span><span class="platform-windows">Git Bash</span>.
1. Navegue para o local do seu repositório do Git.
1. Crie um arquivo `.gitignore` para seu repositório.

   ```shell
   touch .gitignore
   ```

   Se o comando for bem-sucedido, não haverá saída.

Para ver um exemplo de arquivo `.gitignore`, consulte [Algumas configurações comuns do .gitignore](https://gist.github.com/octocat/9257657) no repositório do Octocat.

Se você deseja ignorar um arquivo que já foi ingressado, você deve cancelar o rastreamento do arquivo antes de adicionar uma regra para ignorá-lo. No seu terminal, deixe de rastrear o arquivo.

```shell
git rm --cached FILENAME
```

## Configurar arquivos ignorados para todos os repositórios no seu computador

Você pode dizer ao Git para sempre ignorar determinados arquivos ou diretórios quando fizer um commit em qualquer repositório Git no seu computador. Por exemplo, você pode usar esse recurso para ignorar quaisquer arquivos de backup temporários criados pelo editor de texto.

Para sempre ignorar um determinado arquivo ou diretório, adicione-o a um arquivo chamado `ignore` que está localizado dentro do diretório `~/.config/git`. Por padrão, o Git ignorará todos os arquivos e diretórios listados no arquivo de configuração global `~/.config/git/ignore`. Se o diretório `git` e o arquivo `ignore` ainda não existirem, talvez seja necessário criá-los.

## Como excluir arquivos locais sem criar um arquivo _.gitignore_

Caso não deseje criar um arquivo `.gitignore` para compartilhar com outras pessoas, crie regras que não sejam confirmadas no repositório. Você pode usar essa técnica para arquivos que você gerou localmente e que não espera que outros usuários o façam, como arquivos criados pelo seu editor.

Use seu editor de texto favorito para abrir o arquivo chamado `.git/info/exclude` na raiz do repositório Git. Qualquer regra que você adicionar aqui não será verificada e ignorará arquivos somente em seu repositório local.

1. Abra <span class="platform-mac">Terminal</span><span class="platform-linux">Terminal</span><span class="platform-windows">Git Bash</span>.
1. Navegue para o local do seu repositório do Git.
1. Usando seu editor de texto favorito, abra o arquivo `.git/info/exclude`.

## Leitura Adicional

* [Ignorar arquivos](https://git-scm.com/book/en/v2/Git-Basics-Recording-Changes-to-the-Repository#_ignoring) na documentação do Git
* [.gitignore](https://git-scm.com/docs/gitignore) na documentação do Git
* [Uma coleção de modelos _.gitignore_ úteis](https://github.com/github/gitignore) no repositório github/gitignore
*               Site [gitignore.io](https://www.gitignore.io/)