Ignorando alterações de permissão de arquivo no Git

Para usuários intermediários do Git, é importante entender como gerenciar permissões de arquivos em seu repositório. Às vezes, especialmente ao colaborar em diferentes sistemas operacionais ou ambientes de desenvolvimento, as permissões de arquivo podem aparecer como alterações no status do Git, mesmo quando o conteúdo real permanece inalterado. Isso pode desorganizar seu histórico de commits e criar ruído desnecessário.

Vamos entender neste artigo: como instruir o Git a ignorar essas modificações de permissão.

Compreendendo o problema com alteração de permissão de arquivo no Git

O Git rastreia as permissões de arquivo (executar, ler, gravar) como parte de seu mecanismo de rastreamento de alterações. Quando as permissões são modificadas (por exemplo, usando chmod), o Git vê isso como uma mudança, mesmo que o conteúdo do arquivo em si é idêntico.

Isso pode ser problemático em cenários onde:

• Os desenvolvedores usam sistemas operacionais diferentes: os modelos de permissão de arquivo podem variar entre Windows, macOS e Linux, causando discrepâncias.
• Scripts automatizados modificam permissões: scripts de implantação ou processos de construção podem alterar permissões, criando conjuntos de alterações indesejados.
• Ambientes de desenvolvimento compartilhados: as permissões podem mudar devido às configurações do servidor ou às interações do usuário.

Como ignorar alterações de permissão no Git

O Git oferece algumas maneiras de lidar com isso:

Usando git update-index

O comando git update-index permite um controle refinado sobre como o Git rastreia os arquivos. O --chmod=-x opção diz ao Git para parar de rastrear permissões executáveis para um arquivo ou diretório específico.

git update-index --chmod=-x <file_path>

Por exemplo, para ignorar alterações de permissão para um arquivo chamado script.sh, você pode executar:

git update-index --chmod=-x script.sh

Para aplicar isso recursivamente a um diretório e seu conteúdo, use:

git update-index --chmod=-x -R <directory_path>

Configuração core.FileMode

Para uma solução global ou por repositório, você pode configurar o Git para ignorar alterações de permissão de arquivo por padrão.

Informa ao Git se o bit executável dos arquivos na árvore de trabalho
é para ser rastreado.

Alguns sistemas de arquivos perdem o bit executável quando um arquivo que é
marcado como executável está em check-out ou faz check-out de um
arquivo não executável com bit executável ativado. clone-git(1)
ou git-init(1) teste o sistema de arquivos para ver se ele lida com o 
bit executável corretamente e esta variável é automaticamente
definir conforme necessário.

Um repositório, entretanto, pode estar em um sistema de arquivos que lide com
o modo de arquivo corretamente, e esta variável é definida como verdadeira quando
criado, mas posteriormente pode ser tornado acessível a partir de outro
ambiente que perde o modo de arquivo (por exemplo, exportando ext4
via montagem CIFS, visitando um repositório criado pelo Cygwin com Git
para Windows ou Eclipse). Nesse caso pode ser necessário
para definir esta variável como falsa. Veja git-update-index(1).

O valor padrão é "True" (quando core.filemode não é especificado
no arquivo de configuração).

Isso é feito definindo a opção de configuração core.fileMode como false.

git config core.fileMode false

Esta configuração diz ao Git para ignorar alterações de permissão de arquivo em todo o repositório.

Para definir esta configuração globalmente (para todos os repositórios), use a opção --global:

git config --global core.fileMode false

Arquivo .gitattributes

Para um controle mais granular dentro de um repositório, o arquivo .gitattributes fornece um mecanismo poderoso.

Este arquivo permite definir atributos para arquivos ou caminhos específicos. Para ignorar alterações de permissão para arquivos ou tipos de arquivos específicos, adicione uma linha a .gitattributes com a seguinte sintaxe:

*.<file_extension> -x

Por exemplo, para ignorar alterações de permissão para todos os arquivos .sh, adicione a seguinte linha a .gitattributes:

*.sh -x

Ou, para ignorar as alterações de um arquivo específico:

path/to/my/file.txt -x

Considerações importantes

Embora ignorar alterações de permissão de arquivo possa ser útil em determinados cenários, é essencial considerar o seguinte:

• Implicações de segurança: As permissões de arquivo são um aspecto crucial da segurança. Ignorar alterações de permissão pode ocultar modificações legítimas que podem afetar a segurança do seu aplicativo.
• Colaboração: ao colaborar com outras pessoas, certifique-se de que todos os membros da equipe estejam cientes da permissão do arquivo configurações para evitar confusão.