3. Colocando o projeto sob controle de versão

Navegando pelo terminal

Antes de inicializar nosso primeiro repositório, vamos alinhar como o terminal encontra arquivos e diretórios. Entender bem os caminhos vai te poupar de muita confusão quando começarmos a executar comandos do Git.


Diretório de trabalho atual

Cada aba do terminal é uma sessão de linha de comando independente, e você pode manter várias sessões paralelas abertas lado a lado.

Toda sessão de terminal começa dentro de um diretório específico do seu computador. Esse local é chamado de diretório de trabalho atual (em inglês, current working directory, geralmente abreviado como cwd).

Um diretório é a mesma coisa que uma pasta. Sistemas operacionais diferentes usam termos diferentes, mas significam a mesma coisa.

Enquanto você trabalha no terminal, muitos comandos operam sobre arquivos e diretórios relativos ao diretório de trabalho atual. Claro, você pode navegar para outros diretórios quando precisar.

A maioria dos apps de terminal independentes começa por padrão no diretório pessoal do usuário, mas isso pode ser alterado para qualquer diretório. Os terminais integrados aos editores de código costumam abrir direto no diretório do projeto, então normalmente você já começa no lugar certo.

Para conferir seu diretório atual no terminal, você pode executar o comando

. Ele mostra o caminho completo do diretório atual.

Tarefa
Concluída

Experimente o comando pwd no seu terminal para ver o diretório de trabalho atual.

Se quiser mudar o diretório atual, use o comando

seguido do caminho do diretório que você quer abrir.

Por exemplo, se o seu projeto está em ~/projects/gitbybit, você pode executar:

cd ~/projects/gitbybit

O caminho real do seu projeto pode ser diferente, então use o caminho do seu próprio terminal.


Pegadinhas com espaços e maiúsculas nos caminhos

Repare: se o caminho contém espaços, você precisa colocá-lo entre aspas para que o comando cd o trate como um único argumento.

Por exemplo, se o caminho é C:\Program Files, você executaria o comando cd "C:\Program Files". Você pode usar tanto aspas simples ' quanto duplas ", mas sempre use o mesmo par de aspas.

Por exemplo, se o caminho é /home/alex/my documents, você executaria o comando cd "/home/alex/my documents". Você pode usar tanto aspas simples ' quanto duplas ", mas sempre use o mesmo par de aspas.

Além disso, repare que, na maioria dos sistemas operacionais (incluindo Linux e macOS), os caminhos e comandos diferenciam maiúsculas de minúsculas. Por exemplo, /home/Alex e /home/alex são dois caminhos diferentes.


Caminhos absolutos

Por exemplo, /home/alex/gitbybit-part1C:\Users\Alex\gitbybit-part1 é um caminho absoluto, um caminho que começa no diretório raiz do sistema de arquivos. Caminhos assim são superespecíficos e sempre apontam para o mesmo lugar no seu computador, não importa qual seja o diretório de trabalho atual. Mas eles são específicos do SEU computador, então não ajudam muito em instruções feitas para outras pessoas.

Caminhos absolutos sempre começam com uma letra de unidade (C: no Windows) ou com uma barra (/, que representa a raiz do sistema de arquivos no Linux e no macOS).


Caminhos relativos

Também existem os caminhos relativos, que são relativos a um diretório de trabalho atual. Eles são mais flexíveis e portáteis. Por exemplo, file.txt ou ./file.txt se refere a um arquivo no diretório atual, e ../notes/todo.md aponta para um arquivo dentro da pasta notes, um nível acima.

Os caminhos relativos partem das pastas do projeto, não da raiz do sistema de arquivos inteiro. Um comando que usa um caminho relativo funciona em qualquer computador — desde que todo mundo tenha o projeto organizado do mesmo jeito. Eles são ideais para projetos compartilhados, controle de versão e documentação que outras pessoas possam seguir sem mudar caminhos.

Existem atalhos especiais como . (diretório atual) e .. (diretório pai). Então, para navegar até o diretório pai, você pode usar o comando cd ... Esse comando te leva um nível acima na árvore de diretórios.

Às vezes você vai ver caminhos assim: ./example. Isso significa o mesmo que example (o diretório atual fica implícito). Então, o comando cd ./example é equivalente a cd example.

Você pode combinar esses atalhos com nomes de diretórios para navegar até um diretório específico. Por exemplo, para ir ao diretório example que está dois níveis acima do seu projeto, você executaria o comando cd ../../example.

Muitas ferramentas de linha de comando aceitam caminhos como argumentos, então esse conhecimento serve para muito mais do que o comando cd.

DICA SUPERÚTIL: Você pode usar a tecla Tab do teclado para autocompletar nomes de arquivos e diretórios no terminal. Por exemplo, se você tem um subdiretório src, pode digitar cd s e pressionar Tab para autocompletar o comando para cd src (ou para cd ./src em alguns sistemas, o que dá no mesmo). É um ótimo jeito de evitar erros de digitação e acelerar seu trabalho.

Autocompletar com Tab no terminal.
Legal, bom saber

Você acabou de aprender como funcionam os caminhos e o diretório de trabalho atual, então vamos colocar esse conhecimento à prova.

Neste ponto, seu terminal deve estar no diretório raiz do projeto. É exatamente onde queremos criar nosso repositório. Mas nunca é demais conferir se você está no lugar certo. Porque às vezes...

Vamos fazer uma encenação. Finja que você é um gato tentando ajudar sua pessoa favorita enquanto ela está fora pegando um café. Você, o gato, só conseguiu executar um comando: cd ~ (faça isso agora). Isso vai mudar seu diretório atual, mas daqui a pouco vamos ver como voltar ao diretório do projeto.

Tarefa
Concluída

Agora, usando os comandos que aprendemos até aqui, leve o terminal de volta ao diretório raiz do projeto.

Dica 1: Se você não lembra qual era o diretório do projeto, role o terminal para cima até encontrar a saída do comando pwd que você executou antes.

Dica 2: Se você não sabe o que fazer, abra um novo terminal no diretório do projeto (mas considere isso trapaça).

Ótimo, parece que você entendeu bem os caminhos e o diretório de trabalho atual. Agora vamos usar esse conhecimento para inicializar nosso repositório.

Next step
Quer testar o modo história?

Faça o curso do jeito que ele foi pensado: progressão em pequenas doses, ordem linear e focada, desbloqueio gradual das entradas da Gitopedia. Continue com o Git de verdade no VS Code/Cursor/Antigravity/Windsurf a qualquer momento.

Modo história
GRATUITO
mas precisa de login