LogoLogo
  • Git e GitHub para Humanos
  • Sumário
  • 1. Antes de Começar
    • 1.1 Este livro é para você?
    • 1.2 A razão por trás deste livro
    • 1.3 Visão geral
    • 1.4 Sobre o GitHub
    • 1.5 Sobre a Cumbuca Dev
    • 1.6 O maravilhoso mundo do open source
    • 1.7 Mapa do livro
    • 1.8 Glossário: capítulo 1
  • 2. Fundamentos de Controle de Versão e Git
    • 2.1 Introdução a sistemas de controle de versão
      • 2.1.1 Sistemas de controle de versão centralizados
      • 2.1.2 Sistemas de controle de versão distribuídos
    • 2.2 Introdução ao Git
    • 2.3 Conceitos Fundamentais do Git
      • 2.3.1 Repositório
      • 2.3.2 Commit
      • 2.3.3 Branch
      • 2.3.4 Merge
    • 2.4 Instalando o Git
      • 2.4.1 Instalando no Linux
      • 2.4.2 Instalando no macOS
      • 2.4.3 Instalando no Windows
    • 2.5 Interagindo com o Git
    • 2.6 O Comando Git
    • 2.7 Inicializando de um Repositório Local
    • 2.8 Configurando de um Repositório Local
    • 2.9 Links Úteis: Capítulo 2
    • 2.10 Glossário: Capítulo 2
  • 3. Operações Locais Básicas no Git
    • 3.1 Explorando Operações Locais do Git
    • 3.2 Salvando Alterações Localmente
      • 3.2.1 Adicionando Arquivos ao Controle de Versão via `git add`
      • 3.2.2 Verificando o Estado do Repositório via `git status`
      • 3.2.3 Criando Commits via `git commit`
      • 3.2.4 Visualizando o Histórico do Repositório via `git log`
      • 3.2.5 Comparando Alterações via `git diff`
      • 3.2.6 Unindo os Pontos
      • 3.2.7 Exemplo Prático
    • 3.3 Trabalhando com Branches Localmente
      • 3.3.1 Gerenciando Branches via `git branch`
      • 3.3.2 Alternando Entre Branches via `git switch`
      • 3.3.3 Mesclando Branches via `git merge`
        • 3.3.3.1 Resolvendo Conflitos de Merge
      • 3.3.4 Unindo os Pontos
      • 3.3.5 Exemplo Prático
    • 3.4 Links Úteis: Capítulo 3
    • 3.5 Glossário: Capítulo 3
  • 4. Ajuste de Mudanças Locais no Git
    • 4.1 Desfazendo Alterações Localmente
      • 4.1.1 Desfazendo Alterações Antes do Commit
      • 4.1.2 Desfazendo Commits
      • 4.1.3 Alterando o Último Commit via `git commit --amend`
      • 4.1.4 Unindo os Pontos
      • 4.1.5 Exemplos Práticos
    • 4.2 Ignorando e Removendo Arquivos do Rastreamento Local
      • 4.2.1 Ignorando Arquivos do Rastreamento Utilizando o arquivo .gitignore
      • 4.2.2 Removendo Arquivos do Rastreamento via `git rm`
    • 4.3 Links Úteis: Capítulo 4
    • 4.4 Glossário: Capítulo 4
  • 5. Introdução ao GitHub
    • 5.1 Qual a diferença entre Git e GitHub?
    • 5.2 Grandes Projetos Abertos no GitHub
    • 5.3 Recursos do GitHub
    • 5.4 Idioma Suportado no GitHub
    • 5.5 Contas no GitHub
      • 5.5.1 Conta Pessoal
      • 5.5.2 Conta de Organização
      • 5.5.3 Conta Corporativa
      • 5.5.4 Unindo os Pontos
    • 5.6 Planos do GitHub
    • 5.7 Criando uma Conta Pessoal no GitHub
    • 5.8 Explorando a Interface do GitHub
      • 5.8.1 Página Principal (Home)
      • 5.8.2 Página de Notificações (Notifications)
      • 5.8.3 Página de Configurações (Settings)
    • 5.9 Links Úteis: Capítulo 5
    • 5.10 Glossário: Capítulo 5
  • 6. Repositórios no GitHub
    • 6.1 O quê é um Repositório no GitHub?
    • 6.2 Criando um Repositório no GitHub
    • 6.3 Página Principal de um Repositório: Aba Code
      • 6.3.1 Editando um Arquivo em um Repositório no GitHub
      • 6.3.2 Explorando o Histórico de Commits de um Repositório no GitHub
      • 6.3.3 Editando Detalhes de um Repositório no GitHub
      • 6.3.4 Explorando um Repositório Ativo em Uso
    • 6.4 Página de Configurações de um Repositório: Aba Settings
      • 6.4.1 Gerenciando Configurações Gerais de um Repositório no GitHub: Menu General
      • 6.4.2 Gerenciando Configurações de Colaboração de um Repositório no GitHub: Menu Collaborators
      • 6.4.3 Explorando Configurações de um Repositório no GitHub na Prática
    • 6.5 Links Úteis: Capítulo 6
    • 6.6 Glossário: Capítulo 6
  • 7. Documentação de Projetos
    • 7.1 O quê é Documentação de Projeto?
    • 7.2 Explorando a Linguagem de Marcação Markdown
    • 7.3 Criando uma Página de Apresentação no GitHub
    • 7.4 Links Úteis: Capítulo 7
    • 7.5 Glossário: Capítulo 7
  • 8. Issues no GitHub
    • 8.1 O quê é GitHub Issues?
    • 8.2 Criando uma Issue no GitHub
    • 8.3 Explorando a Página de uma Issue no GitHub
    • 8.4 Atribuindo uma Issue no GitHub
    • 8.5 Categorizando Issues de um Repositório através de Labels no GitHub
      • 8.5.1 Gerenciando Labels de um Repositório no GitHub
    • 8.6 Página de Issues de um Repositório no GitHub: Aba Issues
    • 8.7 Explorando Issues no Mundo Real
    • 8.8 Links Úteis: Capítulo 8
    • 8.9 Glossário: Capítulo 8
  • 9. Git Remoto
    • 9.1 Explorando Operações Remotas do Git
    • 9.2 Interagindo com o Repositório Remoto Central no Git
      • 9.2.1 Clonando um Repositório Remoto via `git clone`
      • 9.2.2 Buscar Atualizações de um Repositório Remoto via `git fetch`
      • 9.2.3 Enviando Mudanças Locais para o Repositório Remoto via `git push`
      • 9.2.4 Sincronizando o Repositório Local com o Remoto via `git pull`
      • 9.2.5 Unindo os Pontos
      • 9.2.6 Exemplo
    • 9.3 Interagindo com o Repositório Remoto hello-world
      • 9.3.1 Conectando-se ao GitHub via SSH
      • 9.3.2 Clonando o Repositório hello-world
      • 9.3.3 Alterando hello-world Localmente
        • 9.3.3.1 Editor de Código
        • 9.3.3.2 Editando README.md
        • 9.3.3.3 Salvando Alterações no Controle de Versão Local
      • 9.3.4 Enviando Alterações para o Repositório Remoto
    • 9.4 Links Úteis: Capítulo 9
    • 9.5 Glossário: Capítulo 9
  • 10. Pull Requests no GitHub
    • 10.1 O quê é um Pull Requests no GitHub?
    • 10.2 Entendendo as Propriedades de um Pull Request no GitHub
      • 10.2.1 Branches de Origem e de Destino de um Pull Request
      • 10.2.2 Título de um Pull Request
      • 10.2.3 Descrição de um Pull Request
      • 10.2.4 Modificações de um Pull Request
      • 10.2.5 Pessoas Revisoras de um Pull Request
      • 10.2.6 Labels de um Pull Request
    • 10.3 Criando um Pull Request no GitHub
    • 10.4 Página de um Pull Request no GitHub
      • 10.4.1 Aba Conversation
      • 10.4.2 Aba Commits
      • 10.4.3 Aba Checks
      • 10.4.4 Aba Files Changed
    • 10.5 Página de Pull Requests de um Repositório no GitHub: Aba Pull Requests
    • 10.6 Recebendo Revisões em um Pull Request no GitHub
      • 10.6.1 Boas Práticas
      • 10.6.2 Exemplo Prático
        • 10.6.2.1 Adicionando Conta Colaboradora
        • 10.6.2.2 Solicitando Revisão de Pull Request
        • 10.6.2.3 Lidando com o Feedback
    • 10.7 Mesclando um Pull Request no GitHub
      • 10.7.1 Exemplo Prático
    • 10.8 Atualizando um Repositório Local Após Mesclagem
    • 10.9 Explorando Pull Requests no Mundo Real
    • 10.10 Links Úteis: Capítulo 10
    • 10.11 Glossário: Capítulo 10
  • 11. Fluxo de Trabalho
    • 11.1 Fork no GitHub
      • Fork
    • 11.2 Forks e Pull Requests
      • 11.2.1 Criando um Fork no GitHub
      • 11.2.2 Clonando um Fork
      • 11.2.3 Realizando Alterações Localmente
      • 11.2.4 Enviando Alterações Locais para o Fork Remoto
      • 11.2.5 Criando um Pull Request a partir de um Fork no GitHub
      • 11.2.6 Sincronizando um Fork no GitHub
      • 11.2.7 Revisão, Mesclagem e Atualizações Pós-mesclagem
    • 11.3 Fluxo de Trabalho
  • 11.4 Links Úteis - Capítulo 11
  • 11.5 Glossário - Capítulo 11
  • 12. O Caminho Continua
    • 12.1 Conhecendo Ferramentas Adicionais
      • 12.1.1 Indicação: Jogo Oh My Git
    • 12.2 Explorando Projetos Open Source
    • 12.3 Crescendo e Colaborando em Comunidades
    • 12.4 Desafio: GitCaos 🔥
    • 12.5 Links Úteis - Capítulo 12
    • 12.6 Glossário Completo: Git e GitHub para Humanos
Fornecido por GitBook
Nesta página
  • Visual Studio Code
  • Como instalar o Visual Studio Code
  • Como alterar o idioma para Português (Brasil)
  • Como abrir a pasta de um projeto
  • Como abrir um arquivo dentro da pasta
  • Como editar um arquivo
  • Como salvar as alterações
  • Como visualizar Markdown formatado (como no GitHub)

Isto foi útil?

Editar no GitHub
Exportar como PDF
  1. 9. Git Remoto
  2. 9.3 Interagindo com o Repositório Remoto hello-world
  3. 9.3.3 Alterando hello-world Localmente

9.3.3.1 Editor de Código

Um editor de código é uma ferramenta usada para escrever e editar programas ou códigos-fonte de softwares. Ao contrário dos editores de texto comuns, como o Bloco de Notas (NotePad), Microsoft Word, Pages ou LibreOffice Writer, um editor de código é otimizado para lidar com linguagens de programação e com a estrutura de códigos.

Algumas das principais vantagens de usar um editor de código:

  • Facilidade de uso e eficiência: Editores de código são mais rápidos e intuitivos, com recursos como autocompletar, sugestões de código, e navegação rápida entre arquivos.

  • Destaque de sintaxe: Eles podem destacar o código de diferentes cores, facilitando a identificação de erros e tornando a leitura do código mais agradável.

  • Integração com ferramentas de versionamento: Editores de código geralmente se integram com Git e outras ferramentas de controle de versão, facilitando o gerenciamento de código.

  • Extensões e personalização: Você pode adicionar extensões para personalizar o editor conforme suas necessidades. Por exemplo, pode instalar extensões para linguagens específicas ou para integrar-se a plataformas como Docker e Kubernetes.

  • Funciona offline: Ao contrário de editores online, como o do GitHub, você pode usar um editor de código local mesmo sem estar conectado à internet.

Imagine que você está escrevendo um livro. Usar um editor de código seria como usar uma ferramenta avançada de processamento de texto, como o Microsoft Word, mas voltada para programadores. Assim como o Word ajuda a organizar um texto, revisar e corrigir erros, o editor de código faz o mesmo com o seu código, com funções específicas para quem cria programas.

Se você usasse um editor de texto simples, como o Bloco de Notas, seria como escrever à mão, sem nenhum auxílio. Com um editor de código, você tem a vantagem de escrever de forma mais rápida, organizada e precisa.

Visual Studio Code

O Visual Studio Code (VSCode) é um dos editores de código mais populares e amplamente utilizados na indústria. Ele é gratuito, open-source e desenvolvido pela Microsoft. Sua popularidade se deve à facilidade de uso, suporte a diversas linguagens de programação e uma grande quantidade de extensões que podem ser instaladas para adicionar mais funcionalidades.

Como instalar o Visual Studio Code

Passo 1: Baixar o Visual Studio Code

  1. Acesse o site oficial do Visual Studio Code: https://code.visualstudio.com/

  2. Na página principal, clique no botão Download.

  3. Escolha a versão correta para o seu sistema operacional:

    • Windows: Escolha a versão "User Installer" caso não tenha certeza.

    • macOS: Baixe o arquivo .dmg.

    • Linux: Escolha entre os pacotes .deb (Debian/Ubuntu) ou .rpm (Fedora/RHEL).

Passo 2: Instalar o Visual Studio Code

No Windows

  1. Após o download, abra o arquivo .exe.

  2. Na tela de instalação, clique em Avançar.

  3. Aceite os termos de uso e continue clicando em Avançar.

  4. Marque a opção "Adicionar ao PATH" para facilitar o uso no futuro.

  5. Clique em Instalar e aguarde a conclusão.

Caso esteja enfrentando dificuldades, você pode seguir esse blog post, instruções da seção Como baixar e instalar o VS Code no Windows?, que possui o passo a passo com imagens.

No macOS

  1. Abra o arquivo .dmg que você baixou.

  2. Arraste o ícone do Visual Studio Code para a pasta Aplicativos.

  3. Aguarde a cópia do programa e pronto!

No Linux (Ubuntu/Debian)

  1. Abra o terminal.

  2. Navegue até a pasta onde o arquivo .deb foi baixado.

  3. Execute o comando:

    sudo dpkg -i code_*.deb
  4. Caso apareçam erros de dependências, rode:

    sudo apt-get install -f

Passo 3: Abrir o Visual Studio Code

Após a instalação, abra o VSCode seguindo estas opções:

  • Windows: Pesquise por Visual Studio Code no menu Iniciar.

  • macOS: Vá até a pasta Aplicativos e clique no ícone do programa.

  • Linux: Digite code no terminal e pressione Enter.

Como alterar o idioma para Português (Brasil)

Por padrão, o VSCode vem em inglês, mas podemos mudar para português:

  1. Abra o Visual Studio Code.

  2. No menu superior, clique em View > Command Palette....

  3. Digite Configure Display Language e selecione essa opção.

  4. Clique na opção Install additional languages.

  5. Na loja de extensões, procure por Português (Brasil) e clique em Install.

  6. Após a instalação, reinicie o VSCode para aplicar a mudança.

Caso esteja enfrentando dificuldades, você pode seguir esse blog post que possui o passo a passo com imagens.

Como abrir a pasta de um projeto

Para editar arquivos dentro de um projeto, primeiro precisamos abrir a pasta onde ele está salvo:

  1. No menu superior, clique em Arquivo > Abrir Pasta....

  2. Navegue até a pasta do projeto e clique em Selecionar Pasta.

  3. A pasta será carregada e aparecerá na barra lateral esquerda da tela.

Como abrir um arquivo dentro da pasta

  1. Com a pasta do projeto aberta, veja a lista de arquivos no lado esquerdo.

  2. Clique duas vezes no arquivo que deseja editar.

  3. O arquivo será aberto no editor de código no centro da tela.

Como editar um arquivo

  1. Com o arquivo aberto, clique no meio do texto e digite as alterações desejadas.

  2. Faça as mudanças no código ou no texto conforme necessário.

Como salvar as alterações

  1. Após editar, vá até o menu Arquivo.

  2. Clique em Salvar para salvar o arquivo.

Como visualizar Markdown formatado (como no GitHub)

Se o arquivo que você está editando for um arquivo markdown, é possível visualizar como ele irá ficar formatado:

  1. O VSCode mostrará uma pré-visualização formatada do Markdown, igual ao que você veria no GitHub.


Outros editores de código, como Atom e Sublime Text, funcionam de maneira parecida, mas escolhemos o VSCode por ser amplamente adotado na indústria.

Fique tranquilo! Na próxima seção, vamos praticar a edição de arquivos passo a passo, editando o README.md do projeto hello-world!

Anterior9.3.3 Alterando hello-world LocalmentePróximo9.3.3.2 Editando README.md

Atualizado há 3 meses

Isto foi útil?

Com o arquivo markdown aberto, clique no ícone de Pré-Visualização no canto superior direito.