Skip to main content

Adicionar um arquivo a um repositório

Você pode fazer o upload e o commit de um arquivo existente para um repositório no GitHub ou usando a linha de comando.

Platform navigation

Adicionando um arquivo a um repositório em GitHub

Os arquivos que você adiciona a um repositório por meio do navegador são limitados a 25 MiB por arquivo. É possível adicionar arquivos maiores, de até 100 MiB cada um, usando a linha de comando. Para obter mais informações, confira "Como adicionar um arquivo a um repositório usando a linha de comando". Para adicionar arquivos maiores que 100 MiB, você deverá usar Git Large File Storage. Para obter mais informações, confira "Sobre arquivos grandes no GitHub".

Dicas:

  • É possível fazer upload de vários arquivos no GitHub ao mesmo tempo.
  • Se um repositório tiver algum branch protegido, você não poderá editar ou enviar arquivos no branch protegido usando o GitHub. Para obter mais informações, confira "Sobre branches protegidos".

Você pode usar GitHub Desktop para mover suas alterações para um novo branch e fazer commit das mesmas. Para obter mais informações, confira "Fazer commit e revisar as alterações no seu projeto no GitHub Desktop".

  1. No GitHub.com, navegue até a página principal do repositório.

  2. Acima da lista de arquivos, selecione o menu suspenso Adicionar arquivo e clique em Carregar arquivos. Como alternativa, você pode arrastar e soltar arquivos no navegador.

    Captura de tela da página principal de um repositório. Acima da lista de arquivos, um botão, rotulado como "Adicionar arquivo", é destacado em laranja escuro.

  3. Para selecionar os arquivos que você deseja carregar, arraste e solte o arquivo ou pasta ou clique em escolher seus arquivos.

  4. 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".

  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, 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.

  6. Clique em Propor alterações.

Adicionar um arquivo a um repositório usando a linha de comando

Você pode fazer o upload de um arquivo existente para um repositório no GitHub.com usando a linha de comando.

Esse procedimento pressupõe que você já:

Aviso: nunca use git add, commit ou push com informações confidenciais para um repositório remoto. As informações confidenciais pode incluir, entre outros:

Para obter mais informações, confira "Remover dados confidenciais de um repositório".

  1. No seu computador, mova o arquivo do qual deseja fazer upload para o GitHub, no diretório local que foi criado quando o repositório foi clonado.

  2. Abra TerminalTerminalGit Bash.

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

  4. Prepare a arquivo para commit em seu repositório local.

    $ git add .
    # Adds the file to your local repository and stages it for commit. Para cancelar o preparo de um arquivo, use 'git reset HEAD ARQUIVO'.
    
  5. Faça commit do arquivo que você preparou no repositório local.

    $ git commit -m "Add existing 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
    

Leitura adicional