4.3 Inicializando um repositório local

Nesta seção, vamos aprender como iniciar um novo repositório Git na sua máquina utilizando o comando git init. Essa é a etapa fundamental para começar a versionar um projeto com o Git.

git init

O comando git init cria um novo repositório Git. Ele é utilizado principalmente em duas situações:

• Inicializar um repositório em um novo diretório vazio.

• Inicializar um repositório em um diretório existente que ainda não utiliza controle de versão

A maioria dos comandos do Git só funciona dentro de um repositório inicializado. Por isso, este costuma ser o primeiro comando executado ao começar a usar Git em um projeto.

Como funciona

Ao executar git init, o Git cria uma pasta oculta chamada .git dentro do diretório atual.

Essa pasta é onde o Git armazena todas as informações necessárias para o controle de versão, como o histórico de alterações, os estados dos arquivos e outros dados internos do repositório.

Se essa pasta for removida, o Git perde a capacidade de acessar e gerenciar o histórico do projeto. Por isso, a presença do diretório .git é essencial para o funcionamento correto do repositório.

Por que a pasta .git é oculta?

Arquivos e diretórios cujo nome começa com um ponto (.) são tratados como ocultos por padrão em muitos sistemas operacionais. Isso significa que eles não aparecem automaticamente nas listagens comuns de arquivos.

No terminal, arquivos ocultos normalmente não são exibidos por padrão. Para visualizá-los, é preciso usar uma opção específica do comando de listagem. Por exemplo:

• No macOS e no Linux, é possível usar ls -a

• No Windows, usando o PowerShell, é possível usar dir -Force

Manter o diretório .git oculto ajuda a manter a pasta do projeto mais organizada, especialmente em projetos grandes. Além disso, reduz o risco de alterações acidentais.

A imagem abaixo mostra a diferença na listagem de arquivos antes e depois da execução do comando git init.

No exemplo, começamos usando o comando ls, que lista os arquivos e diretórios do diretório atual. Como não há arquivos visíveis, nada é exibido.

Em seguida, usamos ls -a, que mostra todos os arquivos, inclusive os ocultos. Nesse momento, vemos apenas . e ...

Após executar o comando git init, um repositório Git vazio é criado, junto com o diretório oculto .git.

Quando executamos novamente ls, nada parece ter mudado, já que o diretório .git continua oculto. No entanto, ao usar ls -a mais uma vez, a pasta .git passa a aparecer na listagem.

No exemplo acima, primeiro usamos o comando ls, que lista os arquivos e diretórios no diretório atual. Como você pode ver, inicialmente não há nada listado.

Em seguida, usamos ls -a, que mostra todos os arquivos, incluindo os ocultos. Nesse momento, vemos apenas . e .., que são entradas padrão do sistema. Elas indicam o diretório atual e o diretório pai e aparecem em qualquer pasta, mesmo quando não há outros arquivos.

Então, executamos o comando git init, que inicializa um repositório Git vazio e cria o diretório oculto .git.

Quando usamos novamente o comando ls, não vemos nada de diferente, pois .git é oculto. Mas ao usar ls -a novamente, a pasta .git aparece!

Modificar manualmente os arquivos dentro do diretório .git pode corromper o repositório e causar problemas sérios no funcionamento do Git.

Estrutura do comando

Ao longo deste curso, utilizaremos a seguinte estrutura básica do comando git init:

git init [diretório]

O parâmetro diretório é opcional e indica o caminho onde o repositório deve ser inicializado. Se ele não for informado, o Git cria o repositório no diretório atual.

Exemplos de uso

• Inicializar um novo repositório em um novo diretório

  • git init novo-projeto

  • Cria o diretório novo-projeto e inicializa um repositório Git dentro dele. Esse formato é útil quando o projeto ainda não existe e você deseja começar já com o Git configurado desde o início.

• Inicializar um repositório em um projeto existente

  • git init

  • Inicializa um repositório Git no diretório atual. Esse formato é utilizado quando o projeto já existe e você está dentro da pasta do projeto no terminal. O Git cria o diretório oculto .git e passa a acompanhar o histórico de alterações a partir desse momento.

Esta é uma explicação simplificada para fins didáticos. Para explorar todas as possibilidades do comando gitinit, consulte a documentação oficial.