Se um arquivo na pasta de trabalho do seu Mac contiver um texto que começa com version https://git-lfs.github.com/spec/v1, você está vendo o ponteiro do Git LFS em vez do conteúdo do arquivo grande. No Terminal, acesse o repositório, certifique-se de que o Git LFS esteja instalado e inicializado e execute git lfs pull. Esse comando baixa os objetos LFS para o branch com checkout ativo e atualiza os arquivos de trabalho. Ele só pode restaurar o conteúdo que estiver disponível no repositório remoto configurado ou já presente no cache local do LFS. Git LFS FAQ

1. Abra o repositório no Terminal e confirme se o arquivo é um ponteiro

Abra o Terminal e navegue até o diretório do repositório. Se você não tiver certeza de onde fica a pasta, digite cd (incluindo o espaço final), arraste a pasta do repositório do Finder para a janela do Terminal e pressione Return. Verifique se você está em uma árvore de trabalho do Git e inspecione o arquivo, substituindo pelo caminho real dele:

git status --short
head -n 3 'path/to/file.ext'

Um ponteiro típico contém uma linha de versão, uma linha oid sha256: e uma linha de tamanho. O Git LFS armazena esse pequeno ponteiro no Git, enquanto o conteúdo real reside no armazenamento do LFS. Ver o ponteiro em um editor de texto não significa que o editor consiga recuperar o objeto ausente; a recuperação é realizada por meio do Git LFS. Visão geral do Git LFS

2. Instale e inicialize o Git LFS, se necessário

Verifique se o comando está disponível:

git lfs version

Se o Terminal informar que lfs não é um comando do Git, instale o Git LFS usando um método de instalação confiável para o seu Mac; em seguida, abra uma nova janela do Terminal e verifique novamente. A documentação do projeto indica o git lfs install como a configuração única para uma conta de usuário; execute-o para configurar os filtros e ganchos (hooks) do LFS no Git:

git lfs install

Essa configuração é diferente de baixar o conteúdo dos arquivos. Se o LFS tiver sido ignorado durante um clone ou checkout, as Perguntas Frequentes (FAQ) do Git LFS recomendam especificamente a execução de git lfs pull para substituir os ponteiros na árvore de trabalho. Git LFS FAQ

3. Baixe e restaure os arquivos do branch atual

A partir do diretório do repositório, execute:

git lfs pull

O comando busca o conteúdo LFS para a ref atual a partir do repositório remoto padrão e faz o checkout dos arquivos necessários na árvore de trabalho. É a etapa de recuperação mais simples para um clone comum em que o ponteiro pertence ao branch no qual você fez checkout. Aguarde o comando terminar e leia eventuais erros; se um ponteiro permanecer depois disso, significa que o download ou o checkout não foi concluído para aquele arquivo. Referência de comandos do Git LFS

Se você já tiver buscado o objeto anteriormente, mas o arquivo de trabalho ainda contiver um ponteiro, tente:

git lfs checkout -- 'path/to/file.ext'

O git lfs checkout usa o conteúdo disponível no armazenamento local do LFS; ele não baixa nada. Ele restaura arquivos ausentes ou arquivos que contenham o ponteiro correspondente e não sobrescreve arquivos modificados. Isso o torna útil após uma busca bem-sucedida, mas ele não consegue recuperar um objeto que não esteja em cache local nem tenha sido buscado com sucesso. Manual do git-lfs-checkout

4. Se o arquivo ainda exibir um ponteiro

Verifique se o caminho esperado é rastreado pelo LFS e se o repositório tem um repositório remoto configurado:

git lfs ls-files
 git remote -v

Se o git lfs ls-files não listar o arquivo, confirme se as regras comitadas no .gitattributes do branch atual marcam esse caminho para o LFS. Apenas executar git lfs track agora não recupera o conteúdo histórico, e alterar as regras de rastreamento não transforma um blob comum do Git em um objeto LFS. O Git LFS observa que arquivos que já estão em um repositório exigem renormalização e um commit para serem convertidos; não faça essa alteração no repositório apenas para recuperar um arquivo. Git LFS FAQ

Se o arquivo estiver listado, confirme se você está no branch que contém a versão desejada e se o repositório remoto configurado é o que armazena os objetos LFS. Para um repositório remoto configurado diferente, busque desse remoto e restaure a partir do cache local:

git lfs fetch 'remote-name'
git lfs checkout -- 'path/to/file.ext'

O git lfs fetch baixa os objetos, mas não atualiza a cópia de trabalho; o git lfs checkout realiza essa atualização local. Buscar a ref atual por padrão usa o repositório remoto padrão, que segue as regras de seleção de remotos do Git. Manual do git-lfs-fetch

Uma falha no pull pode indicar um problema de conexão, autenticação, acesso ou objeto ausente. Resolva o acesso ao servidor Git/LFS configurado e tente novamente. Se o servidor LFS não tiver mais o objeto, o ponteiro sozinho não conseguirá reconstruir o arquivo original: pergunte a um mantenedor do repositório se outro branch, backup, clone ou armazenamento LFS autorizado o possui. Evite substituir o ponteiro por um conteúdo presumido ou comitá-lo como se fosse o arquivo restaurado.

Confirmar a recuperação

Após um pull ou checkout bem-sucedido, inspecione o arquivo novamente. As primeiras linhas dele não devem mais ser os metadados do ponteiro LFS; use o aplicativo adequado para o tipo de arquivo a fim de confirmar que o conteúdo recuperado abre corretamente. Verifique também o git status --short. Uma alteração de conteúdo pode ser esperada se a sua cópia de trabalho continha o ponteiro, mas examine o caminho relatado antes de adicionar ao stage ou comitar qualquer coisa.

Fontes