Adicionando o código localmente hospedado no GitHub

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

Importar seu código-fonte para o GitHub facilita que você e outras pessoas trabalhem juntas em projetos e gerenciem códigos. O GitHub ajuda você a colaborar, controlar alterações e organizar tarefas, simplificando a criação e o gerenciamento de projetos. Para saber mais, confira Sobre o GitHub e o Git.

Warning

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.

Como adicionar um código-fonte existente ao GitHub

Se você tiver um código-fonte armazenado localmente no computador que seja controlado pelo Git ou não seja controlado por nenhum VCS (sistema de controle de versão), adicione o código ao 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.

Como usar a GitHub CLI

A GitHub CLI é uma ferramenta de código aberto para uso do GitHub na linha de comando do computador. A GitHub CLI pode simplificar o processo de adicionar um projeto existente ao GitHub usando a linha de comando. Para saber mais sobre GitHub CLI, confira Sobre o a CLI do GitHub.

Usando GitHub Desktop

Se você tiver mais familiaridade com uma interface de usuário de apontar e clicar, considere a possibilidade de adicionar seu projeto com o GitHub Desktop. Para saber mais, confira Adicionar um repositório do computador local ao GitHub Desktop.

Convertendo repositórios de outros VCS

Se o código-fonte for controlado por um VCS diferente, como o Mercurial, o Subversion ou o Controle de Versão do Team Foundation, você precisará converter o repositório no Git para adicionar o projeto ao 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ê poderá efetuar push do repositório para o GitHub usando a GitHub CLI ou o Git.

Como adicionar um repositório local ao GitHub com a GitHub CLI
Como adicionar um repositório local ao GitHub usando o Git

Como adicionar um repositório local ao GitHub com a GitHub CLI

Para criar um repositório para seu projeto no GitHub, use o subcomando gh repo create. Quando solicitado, selecione Enviar um repositório local existente ao 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 repositório remoto e efetuar push dele, confirme com Sim quando solicitado para adicionar o repositório remoto e efetuar push dos 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 enviar seus commits por push, passe o sinalizador --push. Para obter mais informações sobre os possíveis argumentos, confira o manual da GitHub CLI.

Como adicionar um repositório local ao GitHub usando o Git

Antes de adicionar seu repositório local a GitHub usando o Git, você deve autenticar em GitHub na linha de comando. Para saber mais, confira Sobre a autenticação no 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 página de Configuração Rápida do GitHub, clique em 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 no 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 em seu repositório local para o GitHub, execute o seguinte comando.
```
git push -u origin main
```
Se a ramificação padrão não for denominada "main", substitua "main" pelo nome da ramificação padrão. Para saber mais, confira Sobre 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 página de Configuração Rápida do GitHub, clique em 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 no 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 em seu repositório local para o GitHub, execute o seguinte comando.
```
git push origin main
```
Se a ramificação padrão não for denominada "main", substitua "main" pelo nome da ramificação padrão. Para saber mais, confira Sobre 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 página de Configuração Rápida do GitHub, clique em 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 no 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 em seu repositório local para o GitHub, execute o seguinte comando.
```
git push origin main
```
Se a ramificação padrão não for denominada "main", substitua "main" pelo nome da ramificação padrão. Para saber mais, confira Sobre branches.