Skip to main content

Configurar o Git para uso com delimitadores de linha

Para evitar problemas com diffs, é possível configurar o Git para operar adequadamente com delimitadores de linhas.

Platform navigation

Sobre os delimitadores de linha

Toda vez que você pressiona return no seu teclado, você insere um caractere invisível denominado delimitadores de linha. Os diferentes sistemas operacionais gerenciam os delimitadores de formas diferentes.

Ao colaborar em projetos com Git e GitHub Enterprise Cloud, o Git pode produzir resultados inesperados se, por exemplo, você estiver trabalhando em uma máquina que use o Windows e o seu colaborador dizer uma mudança no macOS.

Você pode configurar o Git para gerenciar os delimitadores automaticamente para que você possa colaborar efetivamente com pessoas que usam diferentes sistemas operacionais.

Configurações globais para delimitadores de linhas

O comando git config core.autocrlf é usado para alterar a forma como o Git lida com delimitadores de linha. É um argumento único.

No macOS, basta passar input para a configuração. Por exemplo:

$ git config --global core.autocrlf input
# Configure Git to ensure line endings in files you checkout are correct for macOS

No Windows, basta passar true para a configuração. Por exemplo:

$ git config --global core.autocrlf true
# Configure Git to ensure line endings in files you checkout are correct for Windows.
# For compatibility, line endings are converted to Unix style when you commit files.

No Linux, basta passar input para a configuração. Por exemplo:

$ git config --global core.autocrlf input
# Configure Git to ensure line endings in files you checkout are correct for Linux

Configurações por repositórios

Opcionalmente, você pode configurar um arquivo .gitattributes para gerenciar como o Git lê delimitadores de linha em um repositório específico. Quando você faz commit desse arquivo em um repositório, ele substitui a configuração core.autocrlf para todos os colaboradores do repositório. Isso garante um comportamento consistente para todos os usuários, independentemente das configurações e do ambiente Git.

O arquivo .gitattributes deve ser criado na raiz do repositório e deve ser feito o commit como qualquer outro arquivo.

Um arquivo .gitattributes se parece com uma tabela com duas colunas:

  • À esquerda está o nome do arquivo para o Git fazer a correspondência.
  • À direita está a configuração do delimitador de linha que o Git deve usar para esses arquivos.

Exemplo

Veja um arquivo .gitattributes de exemplo. Você pode usá-lo como um modelo para os seus repositórios:

# Set the default behavior, in case people don't have core.autocrlf set.
* text=auto

# Explicitly declare text files you want to always be normalized and converted
# to native line endings on checkout.
*.c text
*.h text

# Declare files that will always have CRLF line endings on checkout.
*.sln text eol=crlf

# Denote all files that are truly binary and should not be modified.
*.png binary
*.jpg binary

Você observará que os arquivos são combinados – *.c, *.sln, *.png –, separados por um espaço e, em seguida, obtém uma configuração – text, text eol=crlf, binary. Iremos analisar algumas possíveis configurações abaixo.

  • text=auto O Git vai manipular os arquivos da forma que achar melhor. Essa é uma boa opção padrão.

  • text eol=crlf O Git sempre converterá delimitadores de linha em CRLF no check-out. Você deve usar isso para arquivos que devem manter finais CRLF, mesmo no OSX ou Linux.

  • text eol=lf O Git sempre converterá delimitadores de linha em LF no check-out. Você deve usar isso para arquivos que devem manter os delimitadores LF, mesmo no Windows.

  • binary O Git entenderá que os arquivos especificados não são texto e não deverá tentar alterá-los. A configuração binary também é um alias para -text -diff.

Atualizar um repositório após alterar delimitadores de linha

Depois de definir a opção core.autocrlf ou fizer commit de um arquivo .gitattributes, o Git altera automaticamente as terminações de linha para corresponder à nova configuração. Você pode descobrir que o Git relata alterações em arquivos que você não modificou.

Para garantir que todas as terminações de linha em seu repositório correspondam com a nova configuração, faça backup dos arquivos com o Git e remova e restaure todos os arquivos para normalizar as terminações de linha.

  1. Antes de adicionar ou confirmar alterações, verifique se o Git aplicou a configuração corretamente. Por exemplo, o Git determina automaticamente se os arquivos em um repositório são arquivos binários ou de texto. Para evitar a corrupção de arquivos binários em seu repositório, recomendamos que você marque explicitamente arquivos como binários em .gitattributes. Para obter mais informações, confira gitattributes – Definir atributos por caminho na documentação do Git.

  2. Para evitar a perda de alterações locais em arquivos no repositório, adicione e confirme todas alterações pendentes executando os comandos a seguir.

    Shell
    git add . -u
    git commit -m "Saving files before refreshing line endings"
    
  3. Para atualizar todos os arquivos no branch atual para refletir a nova configuração, execute os comandos a seguir.

    Shell
    git rm -rf --cached .
    git reset --hard HEAD
    
  4. Para exibir os arquivos reescritos e normalizados, execute o comando a seguir.

    Shell
    git status
    
  5. Opcionalmente, para confirmar todas alterações pendentes no repositório, execute o comando a seguir.

    Shell
    git commit -m "Normalize all the line endings"
    

Leitura adicional