Introdução à sua conta do GitHub

Com uma conta de usuário no GitHub, você pode importar ou criar repositórios, colaborar com outros e conectar-se com a comunidade de GitHub.

Este guia irá ajudar você a configurar sua conta de GitHub e dar os primeiros passos com as funcionalidades de GitHub para colaboração e comunidade.

Parte 1: Configurando sua conta de GitHub

Os primeiros passos para começar com GitHub são criar uma conta, escolher um produto que se adeque melhor às suas necessidades, verificar o seu e-mail, configurar a autenticação de dois fatores e verificar o seu perfil.

Existem vários tipos de contas em GitHub. Toda pessoa que usar GitHub terá sua própria conta de usuário e poderá fazer parte de várias organizações e equipes. A sua conta de usuário é sua identidade em GitHub e representa você como indivíduo.

1. Criar uma conta

Para inscrever-se em uma conta de GitHub, acesse https://github.com/ e siga as instruções.

Para manter a sua conta de GitHub segura, você deverá usar uma senha forte e exclusiva. Para obter mais informações, consulte "Criar uma senha forte".

2. Escolhendo seu produto de GitHub

Você pode escolher GitHub Free ou GitHub Pro para obter acesso a diferentes recursos da sua conta pessoal. Você pode fazer a atualização a qualquer momento se não tiver certeza qual o produto você deseja.

Para obter mais informações sobre todos os planos de GitHub, consulte "Produtos de GitHubde".

3. Verificar endereço de e-mail

Para garantir que você possa utilizar todos os recursos do seu plano de GitHub, verifique o seu endereço de e-mail após inscrever-se em uma nova conta. Para obter mais informações, consulte "Verificar o endereço de e-mail".

4. Configurando a autenticação de dois fatores

A autenticação de dois fatores, ou 2FA, é uma camada extra de segurança usada no logon em sites ou apps. É altamente recomendável que você configure a 2FA para a segurança da sua conta. Para obter mais informações, consulte "Sobre a autenticação de dois fatores".

5. Visualizando seu GitHub perfil e gráfico de contribuição

Seu perfil de GitHub conta a história do seu trabalho por meio dos repositórios e dos gists que você fixou, as associações da organização que você escolheu divulgar, as contribuições que você fez e os projetos que você criou. Para obter mais informações, consulte "Sobre o seu perfil" e "Visualizando as contribuições no seu perfil".

Parte 2: Usando ferramentas e processos de GitHub

Para usar GitHub da melhor forma, você deverá configurar o Git. O Git é responsável por tudo relacionado ao GitHub que acontece localmente no computador. Para colaborar de forma efetiva em GitHub, você escreverá em problemas e pull requests usando o Markdown enriquecido de GitHub.

1. Aprendendo a usar o Git

A abordagem colaborativa do GitHub para o desenvolvimento depende da publicação dos commits do repositório local para GitHub para que outras pessoas vejam, busquem e atualizem outras pessoas que usam o Git. Para obter mais informações sobre o Git, consulte o guia "Manual do Git". Para obter mais informações sobre como Git é usado em GitHub, consulte "Fuxo de GitHub".

2. Configurar o Git

Se você planeja usar o Git localmente no seu computador, por meio da linha de comando, editor de IDE ou texto, você deverá instalar e configurar o Git. Para obter mais informações, consulte "Configurar o Git".

Se você preferir usar uma interface visual, você poderá fazer o download e usar GitHub Desktop. GitHub Desktop vem empacotado com o Git. Portanto não há a necessidade de instalar o Git separadamente. Para obter mais informações, consulte "Introdução ao GitHub Desktop".

Depois de instalar o Git, você poderá conectar-se aos repositórios de GitHub a partir do seu computador local, independentemente de ser o seu próprio repositório ou a bifurcação de outro usuário. Quando você se conecta a um repositório do GitHub a partir do Git, precisa fazer a autenticação no GitHub usando HTTPS ou SSH. Para obter mais informações, consulte "Sobre repositórios remotos."

3. Escolhendo como interagir com GitHub

Todos têm seu próprio fluxo de trabalho único para interagir com GitHub; as interfaces e métodos que você usa dependem da sua preferência e do que funciona melhor para as suas necessidades.

Para obter mais informações sobre como efetuar a autenticação em GitHub com cada um desses métodos, consulte "Sobre autenticação em GitHub".

MétodoDescriçãoCasos de uso
Acesse GitHub.comSe você não precisar trabalhar com arquivos localmente, GitHub permite que você realize a maioria das ações relacionadas ao Gits diretamente no navegador, da criação e bifurcação de repositórios até a edição de arquivos e abertura de pull requests.Esse método é útil se você quiser uma interface visual e precisar fazer mudanças rápidas e simples que não requerem trabalho local.
GitHub DesktopO GitHub Desktop amplia e simplifica o fluxo de trabalho no GitHub.com com uma interface visual, em vez de comandos de texto na linha de comando. Para obter mais informações sobre como começar com GitHub Desktop, consulte "Primeiros passos com o GitHub Desktop".Este método é melhor se você precisa ou deseja trabalhar com arquivos localmente, mas preferir usar uma interface visual para usar o Git e interagir com GitHub.
Editor de IDE ou de textoVocê pode definir um editor de texto padrão, curtir Atom ou Visual Studio Code para abrir e editar seus arquivos com o Git, usar extensões e ver a estrutura do projeto. Para obter mais informações, consulte "Associando editores de texto ao Git".Isto é conveniente se você estiver trabalhando com arquivos e projetos mais complexos e quiser ter tudo em um só lugar, uma vez que os editores de texto ou IDEs muitas vezes permitem que você acesse diretamente a linha de comando no editor.
Linha de comando, com ou sem GitHub CLIPara o controle e personalização mais granulares de como você usa o Git e interage com GitHub, você pode usar a linha de comando. Para obter mais informações sobre como usar comandos do Git, consulte "Folha de informações do Git.

GitHub CLI é uma ferramenta separada de linha de comando separada que você pode instalar e que traz pull requests, problemas, GitHub Actions, e outros recursos de GitHub para o seu terminal, para que você possa fazer todo o seu trabalho em um só lugar. Para obter mais informações, consulte "GitHub CLI".
Isto é muito conveniente se você já estiver trabalhando na linha de comando, o que permite que você evite mudar o contexto, ou se você estiver mais confortável usando a linha de comando.
API de GitHubGitHub tem uma API REST e uma API do GraphQL que você pode usar para interagir com GitHub. Para obter mais informações, consulte "Primeiros passos com a API".A API do GitHub seria muito útil se você quisesse automatizar tarefas comuns, fazer backup dos seus dados ou criar integrações que estendem GitHub.

4. Escrevendo em GitHub

Para deixar sua comunicação clara e organizada nos problemas e pull requests, você pode usar o Markdown enriquecido GitHub para formatação, que combina uma sintaxe fácil de ler e fácil de escrever com algumas funcionalidades personalizadas. Para obter mais informações, consulte "Sobre gravação e formatação no GitHub".

Você pode aprender o Markdown enriquecido de GitHub com o curso "Comunicando-se usando o Markdown" em GitHub Learning Lab.

5. Pesquisando em GitHub

Nossa pesquisa integrada permite que você encontre o que você está procurando entre os muitos repositórios, usuários e linhas de código em GitHub. Você pode pesquisar globalmente em todos os GitHub ou limitar sua pesquisa a um repositório ou organização em particular. Para obter mais informações sobre os tipos de pesquisas que você pode fazer em GitHub, consulte "Sobre pesquisar no GitHub".

Nossa sintaxe de pesquisa permite que você construa consultas usando qualificadores para especificar o que você deseja pesquisar. Para obter mais informações sobre a sintaxe de pesquisa para usar na pesquisa, consulte "Pesquisando em GitHub".

6. Gerenciando arquivos em GitHub

Com GitHub, você pode criar, editar, mover e excluir arquivos no seu repositório ou em qualquer repositório ao qual você tenha acesso de gravação. Você também pode acompanhar o histórico de alterações de um arquvo linha por linha. Para obter mais informações, consulte "Gerenciar arquivos em GitHub".

Parte 3: Colaborando em GitHub

Qualquer quantidade de pessoas pode trabalhar juntas nos repositórios de GitHub. É possível configurar configurações, criar quadros de projetos e gerenciar suas notificações para incentivar uma colaboração eficaz.

1. Trabalhando com repositórios

Criar um repositório

Um repositório é como uma pasta para seu projeto. Você pode ter qualquer número de repositórios públicos e privados na sua conta de usuário. Os repositórios podem conter pastas e arquivos, imagens, vídeos, planilhas e conjuntos de dados, bem como o histórico de revisão para todos os arquivos no repositório. Para obter mais informações, consulte "Sobre repositórios".

Ao criar um novo repositório, você deverá inicializar o repositório com um arquivo README para que as pessoas conheçam o seu projeto. Para obter mais informações, consulte "Criar um novo repositório."

Clonar um repositório

Você pode clonar um repositório existente a partir de GitHub para o seu computador local, facilitando a adição ou remoção dos arquivos, correção de conflitos de merge ou realização de commits complexos. Clonar um repositório extrai uma cópia completa de todos os dados do repositório que o GitHub tem nesse momento, incluindo todas as versões de cada arquivo e pasta do projeto. Para obter mais informações, consulte "Clonar um repositório".

Bifurcar um repositório

Uma bifurcação é uma cópia de um repositório que você gerencia, em que todas as alterações que você fizer não afetarão o repositório original a menos que você envie um pull request para o proprietário do projeto. O uso mais comum das bifurcações são propostas de mudanças no projeto de alguma outra pessoa ou o uso do projeto de outra pessoa como ponto de partida para sua própria ideia. Para obter mais informações, consulte "Trabalhando com as bifurcações".

2. Importar seus projetos

Se você tiver projetos existentes que deseja mover para GitHub, você poderá importar projetos usando o Importador de GitHub, a linha de comando ou as ferramentas externas de migração. Para obter mais informações, consulte "Importando código-fonte para GitHub".

3. Gerenciando colaboradores e permissões

Você pode colaborar em seu projeto com outras pessoas usando os problemas, as pull requests e os quadros de projeto do repositório. Você pode convidar outras pessoas para o seu repositório como colaboradores na aba Colaboradores nas configurações do repositório. Para obter mais informações, consulte "Convidar colaboradores para um repositório pessoal".

Você é o proprietário de qualquer repositório que você cria na sua conta de usuário e você tem controle total sobre repositório. Os colaboradores têm acesso de gravação ao seu repositório, limitando o que eles têm permissão para fazer. Para obter mais informações, consulte "Níveis de permissão para um repositório de conta de usuário".

4. Gerenciar configurações do repositório

Como proprietário de um repositório, você pode configurar diversas configurações, incluindo a visibilidade do repositório, tópicos e a pré-visualização das mídias sociais. Para obter mais informações, consulte "Gerenciar configurações do repositório".

5. Configurar projeto para contribuições úteis

Para incentivar os colaboradores do seu repositório, você precisa de uma comunidade que incentive as pessoas a usar, contribuir e evangelizar o seu projeto. Para obter mais informações, consulte "Criando comunidades de bem-estar" nos guias de código aberto.

Ao adicionar arquivos como diretrizes de contribuição, um código de conduta e uma licença para o repositório é possível criar um ambiente em que seja mais fácil para os colaboradores fazerem contribuições úteis e significativas. Para obter mais informações, consulte "Configurando seu projeto para Contribuições Úteis."

6. Usando os problemas e os quadros de projeto do GitHub

Você pode usar os problemas do GitHub para organizar seu trabalho com problemas e pull requests, bem como gerenciar seu fluxo de trabalho com quadros de projetos. Para obter mais informações, consulte "Sobre os problemas" e "Sobre os quadros de projeto".

7. Gerenciando notificações

As notificações fornecem atualizações sobre a atividade em GitHub que você assinou ou da qual você participou. Se não estiver mais interessado em uma conversa, cancele a assinatura dela, deixe de acompanhar ou personalize os tipos de notificações que você receberá no futuro. Para obter mais informações, consulte "Sobre notificações".

8. Trabalhar com o GitHub Pages

Você pode usar GitHub Pages para criar e hospedar um site diretamente de um repositório do GitHub. For more information, see "About GitHub Pages."

9. Usar GitHub Discussions

Você pode habilitar GitHub Discussions para o repositório ajudar a criar uma comunidade em torno do seu projeto. Mantenedores, colaboradores e visitantes podem usar discussões para compartilhar anúncios, fazer e responder a perguntas e participar de conversas sobre objetivos. Para obter mais informações, consulte "Sobre discussões".

Parte 4: Personalizando e automatizando seu trabalho em GitHub

You can use tools from the GitHub Marketplace, the GitHub API, and existing GitHub features to customize and automate your work.

1. Usar GitHub Marketplace

GitHub Marketplace contains integrations that add functionality and improve your workflow. Você pode descobrir, navegar e instalar ferramentas gratuitas e pagas, incluindo aplicativo GitHubs, aplicativo OAuths, e GitHub Actions em GitHub Marketplace. Para obter mais informações, consulte "Sobre GitHub Marketplace".

2. Usando a API deGitHub

There are two versions of the GitHub API: the REST API and the GraphQL API. You can use the GitHub APIs to automate common tasks, back up your data, or create integrations that extend GitHub. For more information, see "About GitHub's APIs."

3. Criando GitHub Actions

With GitHub Actions, you can automate and customize GitHub's development workflow on GitHub. Você pode criar as suas próprias ações e usar e personalizar ações compartilhadas pela comunidade GitHub. Para obter mais informações, consulte "Aprenda GitHub Actions".

4. Publicando e gerenciando GitHub Package Registry

GitHub Package Registry é um serviço de hospedagem de pacotes de software que permite que você hospede os seus pacotes de software de forma privada ou pública e que você use os pacotes como dependências nos seus projetos. For more information, see “Introduction to GitHub Package Registry."

Parte 5: Criando com segurança em GitHub

GitHub tem uma variedade de recursos de segurança que ajudam a manter códigos e segredos seguros nos repositórios. Algumas funcionalidades estão disponíveis para todos os repositórios, enquanto outras estão disponíveis apenas para repositórios públicos e repositórios com uma licença de Segurança Avançada GitHub. Para uma visão geral das funcionalidades de segurança de GitHub, consulte "Funcionalidades de segurança de GitHub".

1. Proteger o repositório

Como administrador do repositório, você pode proteger os seus repositórios definindo as configurações de segurança do repositório. Elas incluem o gerenciamento de acesso ao seu repositório, a definição de uma política de segurança e o gerenciamento de dependências. Para repositórios públicos e para repositórios privados pertencentes a organizações em que o Segurança Avançada GitHub está habilitado, você também pode configurar o código e a digitalização de segredos para identificar automaticamente vulnerabilidades e garantir que os tokens e chaves não sejam expostos.

Para obter mais informações sobre as medidas que você pode tomar para proteger seus repositórios, consulte "Protegendo seu repositório".

2. Gerenciando suas dependências

Uma grande parte da criação é manter as dependências do seu projeto para garantir que todos os pacotes e aplicativos dos quais você depende estejam atualizados e seguros. Você pode gerenciar as dependências do seu repositório em GitHub, explorando o gráfico de dependências para o seu repositório, usando o Dependabot para aumentar automaticamente os pull requests para manter as suas dependências atualizadas e receber alertas de dependência e atualizações de segurança para dependências vulneráveis.

Para obter mais informações, consulte "Protegendo a cadeia de suprimentos do seu software".

Parte 6: Participando da comunidade de GitHub

There are many ways to participate in the GitHub community. You can contribute to open source projects, interact with people in the Suporte à Comunidade GitHub, or learn with GitHub Learning Lab.

1. Contribuindo para projetos de código aberto

Contributing to open source projects on GitHub can be a rewarding way to learn, teach, and build experience in just about any skill you can imagine. For more information, see “How to Contribute to Open Source" in the Open Source Guides.

You can find personalized recommendations for projects and good first issues based on your past contributions, stars, and other activities in Explore. For more information, see “Finding ways to contribute to open source on GitHub."

2. Interagindo com Suporte à Comunidade GitHub

You can connect with developers around the world in Suporte à Comunidade GitHub to ask and answer questions, learn, and interact directly with GitHub staff.

3. Aprendendo com GitHub Learning Lab

You can learn new skills by completing fun, realistic projects in your very own GitHub repository with GitHub Learning Lab. Each course is a hands-on lesson created by the GitHub community and taught by the friendly Learning Lab bot.

For more information, see “Git and GitHub learning resources."

4. Apoiar a comunidade de código aberto

GitHub Sponsors allows you to make a monthly recurring payment to a developer or organization who designs, creates, or maintains open source projects you depend on. For more information, see “About GitHub Sponsors."

5. Entrar em contato com o Suporte do GitHub

O Suporte do GitHub pode ajudar a solucionar problemas que você encontra ao usar o GitHub. For more information, see “About Suporte do GitHub."

Leia mais

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.