Skip to main content

Renomear um arquivo

Você pode renomear qualquer arquivo no repositório diretamente em GitHub ou usando a linha de comando.

Platform navigation

Renomeando um arquivo em GitHub

A renomeação de um arquivo também oferece a oportunidade de mover o arquivo para um novo local

Dicas:

  • Se você tentar renomear um arquivo em um repositório ao qual não tem acesso, criaremos um fork do projeto para sua conta pessoal e ajudaremos você a enviar uma solicitação de pull para o repositório original depois que você fizer commit da alteração.
  • Os nomes de arquivos criados por meio da interface da Web só podem conter caracteres alfanuméricos e hifens (-). Para usar outros caracteres, crie e faça commit dos arquivos localmente, depois faça push deles para o repositório.
  • Alguns arquivos, como imagens, exigem que a renomeação seja feita usando a linha de comando. Para obter mais informações, confira "Renomear um arquivo".
  1. No repositório, navegue até o arquivo que deseja renomear.
  2. No canto superior direito da exibição de arquivo, clique em para abrir o editor de arquivos.

Captura de tela de um arquivo. No cabeçalho, um botão, rotulado com um ícone de lápis, está contornado em laranja escuro.

  1. No campo de nome do arquivo, insira o nome de arquivo que deseja atribuir. Você também pode atualizar o conteúdo do arquivo ao mesmo tempo. Captura de tela que mostra um arquivo de repositório aberto para edição no navegador da Web. O campo de nome do arquivo está ativo e realçado com um contorno laranja escuro.

  2. Clique em Fazer commit das alterações...

  3. No campo "Mensagem do commit", digite uma mensagem curta e relevante que descreva a alteração que você fez no arquivo. Você pode atribuir o commit a mais de um autor na mensagem de commit. Para obter mais informações, confira "Criar um commit com vários autores".

  4. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. Se seu branch atual for o branch-padrão, você deverá optar por criar um novo branch para seu commit e, em seguida, criar um pull request. Para obter mais informações, confira "Como criar uma solicitação de pull".

    Captura de tela de uma solicitação de pull GitHub mostrando um botão de opção para confirmar diretamente no branch principal ou para criar um branch. O novo branch está selecionado.

  5. Clique em Fazer commit de alterações ou em Propor alterações.

Renomear um arquivo usando a linha de comando

Você pode usar a linha de comando para renomear qualquer arquivo do repositório.

Muitos arquivos podem ser renomeados diretamente no GitHub, mas alguns arquivos, como imagens, exigem que você os renomeie na linha de comando.

Esse procedimento pressupõe que você já:

  1. Abra TerminalTerminalGit Bash.

  2. Mude o diretório de trabalho atual para o seu repositório local.

  3. Renomeie o arquivo especificando o nome antigo e o novo nome que deseja atribuir ao arquivo. Isso fará o stage da alteração para commit.

    git mv OLD-FILENAME NEW-FILENAME
    
  4. Use git status para verificar os nomes de arquivos antigos e novos.

    $ git status
    > # On branch YOUR-BRANCH
    > # Changes to be committed:
    > #   (use "git reset HEAD <file>..." to unstage)
    > #
    > #     renamed: OLD-FILENAME -> NEW-FILENAME
    > #
    
  5. Faça commit do arquivo que você preparou no repositório local.

    $ git commit -m "Rename file"
    # Commits the tracked changes and prepares them to be pushed to a remote repository.
    # Para remover esse commit e modificar o arquivo, use "git reset --soft HEAD~1", faça o commit e adicione o arquivo novamente.
    
  6. Efetue push das alterações no repositório local para o GitHub.com.

    $ git push origin YOUR_BRANCH
    # Pushes the changes in your local repository up to the remote repository you specified as the origin