Altere o nome da ramificação padrão do git init

A partir do Git 2.28 (lançado em 27 de julho de 2020), agora você pode configurar o nome da ramificação criada ao iniciar um novo repositório :

$ git config --global init.defaultBranch main

Depois de definir esta variável, a execução git initproduzirá um repositório cuja ramificação inicial é main:

$ git init
Initialised empty Git repository in /home/thomas/test-git-repo/.git/
$ git status
On branch main

No commits yet

nothing to commit (create/copy files and use "git add" to track)

Notas de lançamento: https://lore.kernel.org/git/[email protected]/

Nas versões do Git anteriores a 2.28, HEADé codificado para apontar para refs/heads/master.

if (create_symref("HEAD", "refs/heads/master", NULL) < 0)

Portanto, não há nenhuma configuração ou opção que você possa passar git initpara alterá-la para outra coisa.

O que é possível, porém, é alterar o que HEADaponta para logo depois git initcom a ajuda de git symbolic-ref:

$ git init
$ git symbolic-ref HEAD refs/heads/test

Isso mudará HEADpara apontar para uma ramificação (ainda não existente) chamada test. Então, quando você criar seu primeiro commit, o branch será chamado testem vez de master.

Uma maneira simples de alterar o HEAD padrão é criar um HEAD no diretório do modelo git. Primeiro, configure seu diretório de modelo para ~/Templates/git.git(ou o que você preferir):

$ git config --global init.templateDir '~/Templates/git.git'
$ cp -r /usr/share/git-core/templates ~/Templates/git.git

Em seguida, crie o arquivo HEADno diretório do modelo:

$ echo 'ref: refs/heads/default' > ~/Templates/git.git/HEAD

E você está pronto para ir! Sempre que você executar git init, receberá a mensagem:

$ git init
Reinitialized existing Git repository in [...]

Por algum motivo, o git decide se deve usar esta mensagem com base na presença do HEADarquivo em .git, em vez de depender se deve ou não .gitser criado. No entanto, realmente não importa qual mensagem ele mostra. Na página de manual do git-init:

A execução git initem um repositório existente é segura. Ele não substituirá as coisas que já estão lá. A principal razão para a reexecução git inité pegar modelos recém-adicionados (ou mover o repositório para outro local, se --separate-git-dirfor fornecido).

Ou seja, git inité garantido que não sobrescreverá o HEADque você colocou no modelo e também não usará o modelo HEADpara sobrescrever um existente HEAD. Como isso está explicitamente documentado, você pode confiar nele.

Além disso, também diz:

Arquivos e diretórios no diretório de modelo cujo nome não começa com um ponto serão copiados para o diretório $GIT_DIRapós sua criação.

O que significa que você também pode confiar que o modelo será copiado imediatamente após a criação de .git, e não posteriormente.

(Claro, esta é minha interpretação pessoal do manual. É totalmente possível que os desenvolvedores do git discordem.)

Uma maneira de definir sua ramificação padrão é editar seu ~/.gitconfigarquivo. Adicione as seguintes linhas:

[init]
  defaultBranch = main

Agora, quando você executar git init, mainserá sua ramificação padrão. Isso é semelhante à corrida git config --global init.defaultBranch mainmencionada por @t-kiley.

Como mencionado, o HEAD é codificado para apontar para o mestre. No entanto, você pode criar um alias de shell, para fazer git inito que quiser. Se você estiver usando bash como seu shell, coloque algo assim em seu .bashrc:

function git_init_fnc () {
  default_branch="main"
  if [[ $1 == "init" ]] && [[ $# -eq 1 ]];then
      git init
      if [[ ! -z $(git branch -a | grep $default_branch) ]]; then
          git checkout "$default_branch"
      else
          git checkout -b "$default_branch"
      fi
  else
      /usr/bin/git "$@"
  fi
}

alias "git"=git_init_fnc

Isso substituirá o comando gitpor uma função. Essa função fará com que o comando seja gitexecutado exatamente da mesma forma, a menos que você esteja chamando git initsem nenhum outro argumento. Quando você chamá git init-lo, ele iniciará o repositório. Em seguida, ele verificará se o ramo "daddy" já existe. Em caso afirmativo, ele verificará esse branch, caso contrário, ele criará o branch e moverá você para ele.

A maioria das respostas para este tópico funciona para algumas versões do git, mas nenhuma resposta funcionou para todas as versões com as quais estou trabalhando (versões git 2.7e ) 2.25.2.30

Mas, graças a todas as suas respostas, consegui misturar suas ideias compartilhadas e finalmente encontrei uma maneira de oferecer suporte a todas as versões com uma configuração:

[ Editar: Acontece que minha observação estava errada. Não funcionou, por causa da minha configuração especial.
Se você tiver problemas com as soluções acima, aqui está outra abordagem (testada para versões git e 2.7) .]2.252.30

init.defaultBranchcombinado com uma função wrapper (apenas para versões git, que não suportam init.defaultBranch, que é consultado uma vez, no início da sessão).

A função empacotada emite um git checkout para o branch padrão configurado, diretamente após um init.

.gitconfig

…
   [init]
    # Usually only works for git >= 2.28.
    # Thus, these dotfiles provide a git wrapper that performs extra
    # action after git init. The git wrapper takes this setting
    # into account, so that it even works for git < 2.28.
    defaultBranch = "main"
…

pseudônimos de bash

#!/usr/bin/env bash

main() {
  wrap_git_if_necessary
}

# if the current git version does not support a custom
# default branch (init.defaultBranch, e.g. main),
# then we wrap it in a function that performs
# extra action on git init.
wrap_git_if_necessary() {
  if ! supports_default_branch &>/dev/null; then
    alias git=git_wrapper
  fi
}

supports_default_branch() {
  command git help --config | grep "init.defaultBranch"
}

# wrap git to make main the default branch on init.
# Is required for git versions < 2.28, which do
# not support init.defaultBranch natively.
git_wrapper() {
  local defaultBranch
  if command git "$@"; then
    if [[ "$1" == "init" ]]; then
      defaultBranch=$(command git config init.defaultBranch || echo "main")
      command git checkout -b "${defaultBranch}"
    fi
  fi
}

main "$@"

Eu encontrei esta pergunta através da pesquisa. Percebo que estou respondendo a uma pergunta antiga, mas para outras pessoas que podem chegar aqui, o GitHub tem uma página sobre como configurar o nome do branch primário para qualquer repositório criado lá, bem como instruções para alterar o nome do branch primário:

Renomeando a ramificação padrão de mestre