Skip to main content

Criar arquivos

Você pode criar arquivos diretamente no GitHub em qualquer repositório no qual tenha acesso de gravação.

Ao criar um arquivo no GitHub, lembre-se do seguinte:

  • Se você tentar criar um arquivo em um repositório ao qual não tem acesso, criaremos uma bifurcação 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 os arquivos localmente e faça commit deles e, em seguida, efetue push deles para o repositório do GitHub.
  • O seu repositório pode ter conjuntos de regras por push habilitados. Os conjuntos de regras por push podem bloquear a criação de um novo arquivo no repositório com base em determinadas restrições. Os conjuntos de regras por push aplicam-se a toda a rede de bifurcação do repositório. O que significa que todos os conjuntos de regras por push configurados no repositório raiz também se aplicarão a cada bifurcação do repositório. Para obter mais informações, confira "Sobre os conjuntos de regras".

Aviso: nunca use git add, commit ou push com informações confidenciais, por exemplo senhas ou chaves de API, para um repositório remoto. Se você já tiver adicionado essas informações, consulte "Remover dados confidenciais de um repositório".

  1. Em GitHub, acesse a página principal do repositório.

  2. No seu repositório, navegue até a pasta em que deseja criar um arquivo.

  3. Acima da lista de arquivos, selecione o menu suspenso Adicionar arquivo e clique em Criar arquivo.

    Como alternativa, é possível clicar em na exibição em árvore de arquivos à esquerda.

    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. No modo de exibição de árvore de arquivos do repositório, um botão com o ícone de sinal de adição também é realçado em laranja escuro.

  4. No campo do nome de arquivo, digite o nome e a extensão do arquivo. Para criar subdiretórios, digite o separador de diretório /.

  5. Na caixa de texto do conteúdo do arquivo, digite o conteúdo para o arquivo.

  6. Para revisar o novo conteúdo, acima do conteúdo do arquivo, clique em Visualizar.

Captura de tela de um arquivo no modo de edição. Acima da caixa de texto usada para editar o conteúdo do arquivo, há uma guia, rotulada "Visualizar", com um contorno laranja escuro.

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

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

  3. Se você tiver mais de um endereço de email associado à sua conta em GitHub, clique no menu suspenso do endereço de email e selecione o email a ser usado como o endereço de email do autor do Git. Apenas endereços de e-mail verificados aparecem neste menu suspenso. Se você habilitou a privacidade do endereço de email, um email sem resposta será o endereço de email do autor de commit padrão. Para obter mais informações sobre a forma exata que o endereço de email sem resposta pode assumir, consulte "Configurar o endereço de e-mail do commit”.

    Captura de tela de uma solicitação de pull do GitHub que mostra um menu suspenso com opções para escolher o endereço de email do autor do commit. octocat@github.com está selecionado.

  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.