Skip to main content

Criar novos arquivos

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

Ao criar um arquivo em GitHub, considere o seguinte:

  • Se você tentar criar um arquivo em um repositório ao qual não tem acesso, faremos um fork do projeto para sua conta pessoal e ajudaremos você a enviar uma solicitação de pull para o repositório original depois de realizar o 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 confirme os arquivos localmente e, em seguida, envie-os por push para o repositório.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 saber mais, 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, confira 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 Add file e clique em Create new file.

    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 realçando "Add file" e o ícone de "sinal de adição", descrito acima, com um contorno laranja.

  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 do commit. Para saber mais, confira Criar um commit com vários autores ou em nome de uma organização.

  3. Abaixo dos campos da mensagem de commit, decida se deseja adicionar seu commit ao ramo atual ou a um novo ramo. 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 saber mais, confira Como criar uma solicitação de pull.

    Captura de tela de um pull request do GitHub mostrando um botão de opção para fazer commit diretamente na branch principal ou criar uma nova branch. A nova ramificação está selecionada.

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