Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Renomear um arquivo

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

Renomeando um arquivo em GitHub

Renomear um arquivo também dá a oportunidade de transferir o arquivo para um novo local

Dicas:

  • If you try to rename a file in a repository that you don’t have access to, we will fork the project to your personal account and help you send a pull request to the original repository after you commit your change.
  • Os nomes de arquivos criados por meio da interface da web podem conter apenas caracteres alfanuméricos e hífens (-). 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, consulte "Renomear um arquivo usando a linha de comando".
  1. No repositório, navegue até o arquivo que deseja renomear.
  2. No canto superior direito da exibição do arquivo, clique em para abrir o editor de arquivos. Ícone Edit file (Editar arquivo)
  3. 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. Editar um nome de arquivo
  4. No final da página, digite uma mensagem de commit curta e significativa que descreva a alteração feita no arquivo. Você pode atribuir o commit a mais de um autor na mensagem de commit. Para obter mais informações, consulte "Criar um commit com vários co-autores." Mensagem do commit para sua alteração
  5. 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, consulte "Criar uma nova pull request." Opções para fazer commit no branch
  6. Clique em Propose file change (Propor alteração no arquivo). Botão Propose changes (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 a renomeação seja feita usando a 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 o git status para verificar os nomes antigo e novo do arquivo.
    $ git status
    > # On branch your-branch
    > # Changes to be committed:
    > #   (use "git reset HEAD ..." to unstage)
    > #
    > #     renamed: old_filename -> new_filename
    > #
  5. Faça o commit do arquivo em que você realizou o stage em seu 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. Push the changes (Faça push das alterações</0> no seu 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