Como o Git lida com links simbólicos?

Se eu tenho um arquivo ou diretório que é um link simbólico e o comprometo em um repositório Git, o que acontece com ele?

Eu diria que ele deixa como um link simbólico até que o arquivo seja excluído e, se você retirar o arquivo de uma versão antiga, ele criará um arquivo normal.

O que faz quando eu excluo o arquivo que ele faz referência? Apenas confirma o link pendente?

O Git apenas armazena o conteúdo do link (ou seja, o caminho do objeto do sistema de arquivos ao qual ele se vincula) em um 'blob', como faria em um arquivo normal. Em seguida, ele armazena o nome, o modo e o tipo (incluindo o fato de ser um link simbólico) no objeto em árvore que representa o diretório que o contém.

Quando você faz check-out de uma árvore que contém o link, ele restaura o objeto como um link simbólico, independentemente de o objeto do sistema de arquivos de destino existir ou não.

Se você excluir o arquivo ao qual o link simbólico faz referência, ele não afetará o link simbólico controlado pelo Git. Você terá uma referência pendente. Cabe ao usuário remover ou alterar o link para apontar para algo válido, se necessário.

Você pode descobrir o que o Git faz com um arquivo, vendo o que ele faz quando o adiciona ao índice. O índice é como um pré-commit. Com o índice confirmado, você pode usar git checkoutpara trazer tudo o que estava no índice de volta ao diretório de trabalho. Então, o que o Git faz quando você adiciona um link simbólico ao índice?

Para descobrir, primeiro, faça um link simbólico:

$ ln -s /path/referenced/by/symlink symlink

O Git ainda não sabe sobre esse arquivo. git ls-filespermite inspecionar seu índice ( saída semelhante a -simpressões stat):

$ git ls-files -s ./symlink
[nothing]

Agora, adicione o conteúdo do link simbólico ao armazenamento de objetos Git, adicionando-o ao índice. Quando você adiciona um arquivo ao índice, o Git armazena seu conteúdo no armazenamento de objetos Git.

$ git add ./symlink

Então, o que foi adicionado?

$ git ls-files -s ./symlink
120000 1596f9db1b9610f238b78dd168ae33faa2dec15c 0       symlink

O hash é uma referência ao objeto compactado que foi criado no armazenamento de objetos Git. Você pode examinar esse objeto se procurar na .git/objects/15/96f9db1b9610f238b78dd168ae33faa2dec15craiz do seu repositório. Este é o arquivo que o Git armazena no repositório, que você pode conferir posteriormente. Se você examinar esse arquivo, verá que ele é muito pequeno. Não armazena o conteúdo do arquivo vinculado.

(Note 120000é o modo listado na ls-filessaída. Seria como 100644um arquivo normal.)

Mas o que o Git faz com esse objeto quando você faz o check-out do repositório e do seu sistema de arquivos? Depende da core.symlinksconfiguração. De man git-config:

core.symlinks

Se falso, os links simbólicos são retirados como pequenos arquivos simples que contêm o texto do link.

Portanto, com um link simbólico no repositório, no check-out, você obtém um arquivo de texto com uma referência a um caminho completo do sistema de arquivos ou um link simbólico adequado, dependendo do valor da core.symlinksconfiguração.

De qualquer forma, os dados referenciados pelo link simbólico não são armazenados no repositório.

Nota do "editor": esta postagem pode conter informações desatualizadas. Por favor, veja os comentários e esta pergunta sobre as mudanças no Git desde 1.6.1.

Diretórios com links simbólicos:

É importante observar o que acontece quando há um diretório que é um link direto. Qualquer pull do Git com uma atualização remove o link e o torna um diretório normal. Isto é o que eu aprendi da maneira mais difícil. Algumas idéias aqui e aqui.

Exemplo

Antes

 ls -l
 lrwxrwxrwx 1 admin adm   29 Sep 30 15:28 src/somedir -> /mnt/somedir

git add/commit/push

It remains the same

Depois git pullE algumas atualizações encontradas

 drwxrwsr-x 2 admin adm 4096 Oct  2 05:54 src/somedir