Instalar o Git

Antes de clonar um repositório, fazer um commit ou abrir um pull request, o Git precisa estar instalado na sua máquina. Esta página aborda as formas mais comuns de instalar o Git no macOS, Windows e Linux, como compilá-lo a partir do código-fonte quando você precisar da versão mais recente, como verificar a instalação e a configuração inicial necessária após qualquer nova instalação.

Uma maneira rápida de verificar se o Git já está instalado é abrir um terminal e solicitar a versão:

git --version
git version 2.43.0

Se você ver um número de versão, o Git está instalado e você pode pular para configurar sua identidade. Se receber command not found (ou o Windows solicitar a instalação de ferramentas de desenvolvedor), escolha seu sistema operacional abaixo.

Como Instalar o Git no Mac

Há três formas comuns de instalar o Git no macOS: o instalador oficial Git for Mac, o Homebrew e o MacPorts. O Homebrew é o mais popular entre desenvolvedores porque também mantém o Git atualizado com brew upgrade. As Apple Command Line Tools também incluem uma versão do Git — executar git --version em um Mac novo oferece a opção de instalá-las.

Instalador para Mac

Esta é a forma mais simples de instalar o Git no Mac. Siga os passos abaixo:

1. Baixe o último instalador Git for Mac.
2. Abra o pacote baixado e siga as instruções para concluir a instalação.
3. Abra o Terminal e execute git --version para verificar se a instalação foi bem-sucedida:

git --version
git version 2.43.0

Com o Git na sua máquina, configure sua identidade para que seus commits sejam atribuídos corretamente.

Homebrew

Se você tem o Homebrew instalado, esta é a forma mais fácil de manter o Git atualizado:

1. Abra seu terminal e instale o Git com o Homebrew:

Instalando o Git via Homebrew

brew install git

2. Verifique a instalação:

Instalar o Git com Homebrew

git --version
git version 2.43.0

Posteriormente, atualize para a versão mais recente a qualquer momento com brew upgrade git.

MacPorts

Siga estas instruções para instalar o Git com o MacPorts:

1. Atualize o MacPorts:

Instalar o Git com MacPorts

sudo port selfupdate

2. Pesquise os ports mais recentes do Git e suas variantes:

Pesquisar ports e variantes do Git

port search git
port variants git

3. Instale o Git junto com a conclusão automática do bash, o auxiliar de keychain do macOS e a documentação:

Instalando o Git com o auxiliar de keychain do macOS

sudo port install git +bash_completion +credential_osxkeychain +doc

A variante +credential_osxkeychain permite que o Git armazene suas credenciais remotas no Keychain do macOS, para que você não seja solicitado a inserir uma senha a cada push.

Como Instalar o Git no Windows

O pacote recomendado é o Git for Windows, que inclui a linha de comando do Git, o Git Bash (um shell estilo Unix) e uma interface gráfica opcional.

1. Baixe o instalador Git for Windows mais recente.
2. Execute o instalador. O assistente de configuração oferece várias opções — os padrões são adequados. Duas merecem atenção:
   • Editor padrão: escolha o editor que você já usa (VS Code, Notepad, Vim, …) para mensagens de commit.
   • Ambiente PATH: "Git from the command line and also from 3rd-party software" permite executar git tanto no Prompt de Comando/PowerShell quanto no Git Bash.
3. Após a instalação, abra o Git Bash (ou PowerShell) e verifique:

git --version
git version 2.43.0.windows.1

Como Instalar o Git no Linux

No Linux, instale o Git pelo gerenciador de pacotes da sua distribuição. O pacote é quase sempre chamado git.

Debian / Ubuntu ( apt-get )

Debian, Ubuntu e seus derivados usam o APT. Atualize o índice de pacotes primeiro para obter a versão mais recente disponível:

Instalar o Git no Debian/Ubuntu

sudo apt-get update
sudo apt-get install git

Em seguida, verifique a instalação:

git --version

git --version
git version 2.43.0

Fedora (dnf/yum)

Os pacotes do Git estão disponíveis via dnf. (Nota: o yum está obsoleto nas versões modernas do Fedora.)

1. Instale o Git usando o dnf:

Instalar o Git via dnf

sudo dnf install git

2. Verifique a instalação:

Verificar a versão do git

git --version
git version 2.43.0

Outras distribuições seguem o mesmo princípio com seus próprios gerenciadores de pacotes — por exemplo, sudo pacman -S git no Arch, ou sudo zypper install git no openSUSE.

Como Instalar o Git a Partir do Código-Fonte no Linux

Os pacotes das distribuições podem estar desatualizados em relação ao último lançamento do Git. Compilar a partir do código-fonte é a maneira de obter os recursos mais recentes assim que são lançados — ao custo de instalar dependências de compilação e recompilar a cada atualização. Você precisará de bibliotecas como curl, zlib, openssl, expat e gettext. Em sistemas com dnf/yum ou apt-get, instale as dependências primeiro:

Dependências no Fedora/RHEL (dnf/yum)

sudo yum install curl-devel expat-devel gettext-devel \
openssl-devel zlib-devel perl-devel asciidoc xmlto

Dependências no Debian/Ubuntu (apt-get)

sudo apt-get install libcurl4-openssl-dev libexpat1-dev gettext \
libz-dev libssl-dev

Para compilar a documentação do Git em outros formatos (páginas man, HTML, info), adicione também estas dependências:

Instalar o Git e adicionar formatos de documentação

sudo dnf install asciidoc xmlto docbook2X
sudo apt-get install asciidoc xmlto docbook2x

Em seguida, baixe um tarball de lançamento dos lançamentos do código-fonte do Git, depois compile e instale:

Instalar o Git, compilar e instalar

tar -zxf git-<version>.tar.gz
cd git-<version>
make prefix=/usr/local all
sudo make prefix=/usr/local install

Após a instalação, verifique se o Git está no seu PATH executando git --version. Se o comando não for encontrado, adicione /usr/local/bin à sua variável de ambiente PATH.

Se você já tiver uma compilação do Git disponível, pode buscar o código-fonte mais recente diretamente em vez de baixar um tarball:

Obtendo o código-fonte

git clone https://github.com/git/git.git

Configurar o Git Após a Instalação

Uma instalação nova do Git não sabe quem você é. Antes do seu primeiro commit, defina seu nome e e-mail — o Git os registra em cada commit que você faz. A opção --global os armazena uma vez para sua conta de usuário, para que você não precise repetir isso em cada repositório:

Definir sua identidade no Git

git config --global user.name "Bob Smith"
git config --global user.email "[email protected]"

Também é comum definir o nome padrão do branch e o editor preferido:

Configurações comuns de primeira vez

git config --global init.defaultBranch main
git config --global core.editor "code --wait"

Verifique o que está configurado a qualquer momento:

Listar sua configuração

git config --list

Para um guia completo dessas configurações e onde o Git as armazena, consulte Git Config.

Verificar a Instalação

Após instalar em qualquer plataforma, confirme que o Git está no seu PATH:

git --version
git version 2.43.0

Se você ver command not found, o diretório de instalação não está no seu PATH. Em uma compilação a partir do código-fonte, o binário geralmente fica em /usr/local/bin — adicione-o ao PATH e reinicie seu terminal. O número exato da versão que você vê depende do que foi incluído no seu instalador ou pacote, portanto pode diferir dos exemplos acima.

Próximos Passos

Com o Git instalado e configurado, você está pronto para começar a trabalhar com repositórios:

• Git Repository — o que é um repositório e como o Git rastreia seu projeto.
• git init — criar um repositório do zero.
• git clone — copiar um repositório existente para sua máquina.
• Generate an SSH Key — conectar-se com segurança a repositórios remotos como o GitHub sem digitar uma senha.

Prática