Adicionando o código localmente hospedado no GitHub

Sobre a importação do código-fonte

Importar o código-fonte para GitHub facilitar que você e outras pessoas trabalhem em conjunto em projetos e gerenciem código. GitHub ajuda você a colaborar, acompanhar alterações e organizar tarefas, tornando mais simples criar e gerenciar projetos. Para saber mais, confira O que é o GitHub?.

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.

Adicionando o código-fonte existente a GitHub

Se você tiver o código-fonte armazenado localmente em seu computador que seja acompanhado pelo Git ou não acompanhado por qualquer VCS (sistema de controle de versão), você poderá adicionar o código GitHub digitando comandos em um terminal. Para fazer isso, digite os comandos do Git diretamente. Como alternativa, você pode usar GitHub CLI ou GitHub Desktop.

Usando GitHub CLI

GitHub CLIé uma ferramenta código aberto para usar GitHub na linha de comando do computador. GitHub CLI pode simplificar o processo de adição de um projeto existente ao GitHub uso da linha de comando. Para saber mais sobre GitHub CLI, consulte Sobre GitHub CLI.

Usando GitHub Desktop

Se você se sente mais à vontade com uma interface de apontar e clicar, considere adicionar seu projeto com GitHub Desktop em vez disso. Para saber mais, confira Adicionar um repositório do computador local ao GitHub Desktop.

Convertendo repositórios de outros sistemas de controle de versão (VCS)

Se o código-fonte for acompanhado por um VCS diferente, como Mercurial, Subversion ou Team Foundation Version Control, você deverá converter o repositório em Git antes de adicionar o projeto a GitHub.

Como inicializar um repositório Git

Se o código hospedado localmente não for controlado por nenhum VCS, a primeira etapa será inicializar um repositório Git. Se o projeto já for controlado pelo Git, vá para Como importar um repositório Git com a linha de comando.

Abra TerminalTerminalGit Bash.
Navegue até o diretório raiz do projeto.
Inicialize o diretório local como um repositório Git. Por padrão, o branch inicial é chamado main.

Se estiver usando o Git 2.28.0 ou uma versão posterior, você poderá definir o nome do branch padrão usando -b.
```
git init -b main
```
Se estiver usando o Git 2.27.1 ou uma versão anterior, você poderá definir o nome do branch padrão usando git symbolic-ref.
```
git init && git symbolic-ref HEAD refs/heads/main
```

Adicione os arquivos ao novo repositório local. Isso faz stage deles para o primeiro commit.

$ git add .
# Adds the files in the local repository and stages them for commit. Para cancelar o preparo de um arquivo, use 'git reset HEAD ARQUIVO'.

Faça commit dos arquivos com stage em seu repositório local.

$ git commit -m "First commit"
# 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.

Como importar um repositório Git com a linha de comando

Depois de inicializar um repositório Git, você pode enviar o repositório para GitHub usando GitHub CLI ou Git.

Adicionando um repositório local com GitHubGitHub CLI
Adicionando um repositório local a GitHub usando Git

Adicionando um repositório local a GitHub com GitHub CLI

Para criar um repositório para o seu projeto em GitHub, use o subcomando gh repo create. Quando solicitado, selecione Fazer push de um repositório local existente para GitHub e digite o nome desejado para seu repositório. Caso você deseje que o seu projeto pertença a uma organização em vez da sua conta de usuário, especifique o nome da organização e o nome do projeto com ORGANIZATION-NAME/PROJECT-NAME.
Siga as instruções interativas. Para adicionar o controle remoto e fazer push do repositório, confirme sim quando solicitado para adicionar o controle remoto e enviar os commits para o branch atual.
Como alternativa, para ignorar todos os prompts, forneça o caminho para o repositório com o sinalizador --source e passe um sinalizador de visibilidade (--public, --private ou --internal). Por exemplo, gh repo create --source=. --public. Especifique um repositório remoto com o sinalizador --remote. Para efetuar push dos seus commits, passe o sinalizador --push. Para obter mais informações sobre possíveis argumentos, consulte o GitHub CLI manual.

Adicionar um repositório local ao GitHub usando o Git

Antes de adicionar seu repositório local ao GitHub usando o Git, você deve se autenticar no GitHub por meio da linha de comando. Para saber mais, confira Sobre a autenticação para GitHub.

Crie um novo repositório em GitHub. Para evitar erros, não inicialize o novo repositório com arquivos LEIAME, de licença ou gitignore. É possível adicionar esses arquivos após o push do projeto para o GitHub. Para saber mais, confira Criar um repositório.
Na parte superior do repositório na GitHubpágina de Instalação Rápida, clique para copiar a URL do repositório remoto.
Abra TerminalTerminalGit Bash.
Altere o diretório de trabalho atual para seu projeto local.
Para adicionar a URL do repositório remoto ao qual o repositório local será enviado, execute o seguinte comando. Substitua REMOTE-URL pela URL completa do repositório em GitHub.
```
git remote add origin REMOTE-URL
```
Para saber mais, confira Gerenciar repositórios remote.
Para verificar se você definiu a URL remota corretamente, execute o seguinte comando.
```
git remote -v
```
Para enviar as alterações do seu repositório local para GitHub, execute o comando a seguir.
```
git push -u origin main
```
Se a ramificação padrão não for chamada "main", substitua "main" pelo nome da sua ramificação padrão. Para saber mais, confira Branches.

Crie um novo repositório em GitHub. Para evitar erros, não inicialize o novo repositório com arquivos LEIAME, de licença ou gitignore. É possível adicionar esses arquivos após o push do projeto para o GitHub. Para saber mais, confira Criar um repositório.
Na parte superior do repositório na GitHubpágina de Instalação Rápida, clique para copiar a URL do repositório remoto.
Abra TerminalTerminalGit Bash.
Altere o diretório de trabalho atual para seu projeto local.
Para adicionar a URL do repositório remoto ao qual o repositório local será enviado, execute o seguinte comando. Substitua REMOTE-URL pela URL completa do repositório em GitHub.
```
git remote add origin REMOTE-URL
```
Para saber mais, confira Gerenciar repositórios remote.
Para verificar se você definiu a URL remota corretamente, execute o seguinte comando.
```
git remote -v
```
Para enviar as alterações do seu repositório local para GitHub, execute o comando a seguir.
```
git push origin main
```
Se a ramificação padrão não for chamada "main", substitua "main" pelo nome da sua ramificação padrão. Para saber mais, confira Branches.

Crie um novo repositório em GitHub. Para evitar erros, não inicialize o novo repositório com arquivos LEIAME, de licença ou gitignore. É possível adicionar esses arquivos após o push do projeto para o GitHub. Para saber mais, confira Criar um repositório.
Na parte superior do repositório na GitHubpágina de Instalação Rápida, clique para copiar a URL do repositório remoto.
Abra TerminalTerminalGit Bash.
Altere o diretório de trabalho atual para seu projeto local.
Para adicionar a URL do repositório remoto ao qual o repositório local será enviado, execute o seguinte comando. Substitua REMOTE-URL pela URL completa do repositório em GitHub.
```
git remote add origin REMOTE-URL
```
Para saber mais, confira Gerenciar repositórios remote.
Para verificar se você definiu a URL remota corretamente, execute o seguinte comando.
```
git remote -v
```
Para enviar as alterações do seu repositório local para GitHub, execute o comando a seguir.
```
git push origin main
```
Se a ramificação padrão não for chamada "main", substitua "main" pelo nome da sua ramificação padrão. Para saber mais, confira Branches.

Leitura adicional

Adicionar um arquivo a um repositório

Platform navigation

Neste artigo