Configurar o Git para o GitHub Desktop

Você pode gerenciar as configurações do Git para seus repositórios locais com GitHub Desktop.

Platform navigation

Neste artigo

Sobre a configuração do Git para GitHub Desktop

GitHub Desktop usa as configurações locais do Git e fornece a opção de definir algumas dessas configurações, como as informações de autor global e o branch padrão usado ao criar um novo repositório.

GitHub Desktop permite que você defina o nome e o endereço de email que deseja associar às confirmações que você faz em seus repositórios. Se seu nome e endereço de email já tiverem sido definidos na configuração global do Git para seu computador, GitHub Desktop detectará e usará esses valores. GitHub Desktop também permite que você defina um nome e um endereço de email diferentes para um repositório individual. Isso é útil quando você precisa usar um endereço de email de trabalho separado para um repositório específico.

Se o endereço de e-mail definido na sua configuração do Git não corresponder a um endereço de e-mail associado à conta GitHub na qual você tem sessão iniciada no momento, GitHub Desktop exibirá um aviso antes de fazer o commit.

GitHub Desktop também permite que você altere o nome de branch padrão que deseja usar ao criar novos repositórios. Por padrão, GitHub Desktop usa main como nome padrão da branch em todos os novos repositórios que você criar.

Dica

Se você fizer commits públicos, qualquer pessoa poderá ver o endereço de e-mail da sua configuração do Git. Para saber mais, confira Configurar o endereço de e-mail do commit.

Como configurar as informações de autor global

Configurar suas informações globais de autor no GitHub Desktop atualizará o nome e o endereço de e-mail na sua configuração global do Git. Esse será o nome padrão e o endereço de email para todos os novos repositórios locais que você criar.GitHub Desktop

  1. Na barra de menus, selecione GitHub Desktop e selecione Configurações.

    Captura de tela da barra de menus no Mac. No menu suspenso “GitHub Desktop” aberto, o cursor passa sobre a opção “Configurações”, que está realçada em azul.

  2. Na janela “Configurações”, selecione Git.

    Captura de tela do painel "Git" na janela "Configurações". Na barra lateral esquerda, há uma opção rotulada "Git" realçada em azul com o contorno em laranja.

  3. No campo "Nome", digite o nome que gostaria de usar para sua configuração do Git.

  4. No menu suspenso "Email", selecione o endereço de email que gostaria de usar em seus commits. Você pode selecionar um endereço de email associado à sua conta do GitHub ou selecionar "Outro" e inserir outro endereço de email.

  5. Clique em Salvar.

  1. Use o menu Arquivo e clique em Opções.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "File" que é expandido, o item "Options" está contornado em laranja.

  2. Na janela “Opções”, clique em Git.

    Captura de tela do painel “Git” na janela “Opções”. Na barra lateral esquerda, uma opção rotulada como "Git" é realçada em azul.

  3. No campo "Nome", digite o nome que gostaria de usar para sua configuração do Git.

  4. No menu suspenso "Email", selecione o endereço de email que gostaria de usar em seus commits. Você pode selecionar um endereço de email associado à sua conta do GitHub ou selecionar "Outro" e inserir outro endereço de email.

  5. Clique em Salvar.

Como configurar diferentes informações de autor para um repositório individual

Você pode alterar o nome e o endereço de email usados para criar commits em um repositório específico. Essa configuração local do Git substituirá as configurações globais do Git somente para este repositório.

  1. Para alternar para o repositório em que deseja definir uma configuração específica, use o menu suspenso "Repositório Atual".

    Captura de tela da barra de repositórios no GitHub Desktop. Ao lado de "Repositório Atual" há um ícone suspenso realçado com contorno laranja.

  2. Na barra de menus "GitHub Desktop", selecione Repositório e clique em Configurações do repositório... .

    Captura de tela da barra de menus no Mac. No menu suspenso "Repositório" que é aberto, o cursor do mouse está sobre "Configurações do repositório", realçado em azul.

  3. Na janela "Configurações do Repositório", na barra lateral esquerda, clique em Configuração do Git.

  4. Em "Para este repositório eu desejo", selecione Usar uma configuração local do Git. Captura de tela do painel "Configuração do Git" na janela "Configurações do Repositório". Um botão de opção "Use a local Git config" está selecionado e contornado em laranja.

  5. No campo "Nome", digite o nome que gostaria de usar na configuração do Git local.

  6. No menu suspenso "Email", selecione o endereço de email que gostaria de usar em seus commits. Você pode selecionar um endereço de email associado à sua conta do GitHub ou selecionar "Outro" e inserir outro endereço de email.

  7. Clique em Salvar.

  1. No menu Repositório, clique em Configurações do repositório... .

    Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "Repository" que é aberto, "Repository Settings" está contornado em laranja.

  2. Na janela "Configurações do Repositório", na barra lateral esquerda, clique em Configuração do Git.

  3. Em "Para este repositório eu desejo", selecione Usar uma configuração local do Git. Captura de tela do painel "Configuração do Git" na janela "Configurações do Repositório". Um botão de opção "Use a local Git config" está selecionado e contornado em laranja.

  4. No campo "Nome", digite o nome que gostaria de usar na configuração do Git local.

  5. No menu suspenso "Email", selecione o endereço de email que gostaria de usar em seus commits. Você pode selecionar um endereço de email associado à sua conta do GitHub ou selecionar "Outro" e inserir outro endereço de email.

  6. Clique em Salvar.

Como configurar o branch padrão para novos repositórios

Você pode configurar o branch padrão que será usado ao criar um novo repositório em GitHub Desktop. Para mais informações sobre o branch padrão, confira Sobre ramificações.

  1. Na barra de menus, selecione GitHub Desktop e selecione Configurações.

    Captura de tela da barra de menus no Mac. No menu suspenso “GitHub Desktop” aberto, o cursor passa sobre a opção “Configurações”, que está realçada em azul.

  2. Na janela “Configurações”, selecione Git.

    Captura de tela do painel "Git" na janela "Configurações". Na barra lateral esquerda, há uma opção rotulada "Git" realçada em azul com o contorno em laranja.

  3. Clique na guia Ramificação padrão.

  4. Edite o nome do branch padrão conforme necessário.

  5. Clique em Salvar.

  1. Use o menu Arquivo e clique em Opções.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "File" que é expandido, o item "Options" está contornado em laranja.

  2. Na janela “Opções”, clique em Git.

Captura de tela do painel “Git” na janela “Opções”. Na barra lateral esquerda, uma opção rotulada como "Git" é realçada em azul.

  1. Clique na guia Ramificação padrão.
  2. Edite o nome do branch padrão conforme necessário.
  3. Clique em Salvar.

Configurando seu ambiente de shell para ganchos do Git

GitHub Desktop executa hooks do Git em seu ambiente do shell configurado. Isso significa que os ganchos têm acesso às mesmas variáveis de ambiente, arquivos de configuração de shell (como .bash_profile ou .zshrc) e ferramentas como quando você executa o Git na linha de comando. As ferramentas instaladas por meio de gerenciadores de versão, como nvm ou rbenv, também estarão disponíveis para seus ganchos.

Você pode definir as configurações de ambiente de gancho na guia Ganchos do painel de configurações do Git .

  1. Na barra de menus, selecione GitHub Desktop e selecione Configurações.

    Captura de tela da barra de menus no Mac. No menu suspenso “GitHub Desktop” aberto, o cursor passa sobre a opção “Configurações”, que está realçada em azul.

  2. Na janela “Configurações”, selecione Git.

    Captura de tela do painel "Git" na janela "Configurações". Na barra lateral esquerda, há uma opção rotulada "Git" realçada em azul com o contorno em laranja.

  3. Clique na guia Hooks.

  1. Use o menu Arquivo e clique em Opções.

    Captura de tela da barra de menus "GitHub Desktop" no Windows. No menu suspenso "File" que é expandido, o item "Options" está contornado em laranja.

  2. Na janela “Opções”, clique em Git.

Captura de tela do painel “Git” na janela “Opções”. Na barra lateral esquerda, uma opção rotulada como "Git" é realçada em azul.

  1. Clique na guia Hooks.

As configurações a seguir estão disponíveis:

  • Carregar variáveis de ambiente do hook do Git a partir do shell: Quando habilitado, GitHub Desktop carrega variáveis de ambiente a partir do shell ao executar hooks do Git. Habilite isso se os ganchos dependerem das ferramentas instaladas por meio de gerenciadores de versão, como nvm, rbenv ou asdf.
  • Cache de variáveis de ambiente de gancho do Git: armazena em cache variáveis de ambiente de gancho para melhorar o desempenho. Desabilite isso se os ganchos dependerem de variáveis de ambiente que mudam com frequência.

Para obter mais informações sobre os ganchos do Git, GitHub Desktopconsulte Trabalhando com ganchos do Git no GitHub Desktop.

Leitura adicional