Solucionado (ver solução)
Solucionado
(ver solução)
5
respostas

Aperfeiçoando seu VS Code - Guia Prático com códigos

Insira aqui a descrição dessa imagem para ajudar na acessibilidade

Aperfeiçoando seu VS Code - Guia Prático com códigos

Por Ricardo Costa Val do Rosario auxiliado por Microsoft Copilot 365

Prompt de Comando

1. Objetivo
- Criar, exportar, armazenar e restaurar perfis do VS Code em diferentes máquinas

2. Especificações
- Perfis a serem criados
1. Python
2. Web
3. C/C++
4. Produtividade
- Cada perfil deve conter
1. Extensões específicas da linguagem/uso
2. Configurações (settings.json) adequadas
- Exportar cada perfil após configurado
- Armazenar os arquivos .code-profile ou links gerados em local seguro 
(ex.: OneDrive, GitHub, pendrive)
- Importar perfis em nova máquina para restaurar ambiente

3. Restrições
1. Não incluir links fictícios
2. Usar apenas recursos reais do VS Code (Perfis → Exportar/Importar)
3. Garantir que cada perfil seja independente 
4. Não misturar extensões desnecessárias
5. Sempre testar após importar para validar extensões e configs aplicadas

4. Etapas
1. Criar perfis no VS Code (config → Perfis → Criar)
2. Instalar extensões específicas de cada perfil
3. Ajustar settings.json conforme necessidade
4. Exportar perfis (config→ Perfis → Exportar)
5. Guardar os arquivos/links em backup seguro
6. Em nova máquina: instalar VS Code → Importar perfis
7. Testar cada perfil com um projeto real
8. Atualizar backup se houver mudanças

1. Apresentação

- Conhecimento guardado é como sabedoria oculta ou tesouro escondido: existe, mas não 
transforma. Este documento nasceu justamente para evitar isso. 

- Aqui você encontrará um passo a passo claro, organizado e acessível para transformar o 
Visual Studio Code em um verdadeiro parceiro de jornada, um ambiente que se adapta a 
você, acompanha seu ritmo e pode ser levado para qualquer máquina como se fosse uma extensão 
da sua própria mente criativa.

- A proposta é simples: mostrar que configurar, exportar e restaurar perfis não é um mistério, 
mas sim um processo lógico, quase um algoritmo de vida prática. 

- Ao final, você terá não apenas um editor de código, mas um companheiro de trabalho 
confiável, pronto para Python, Web, C/C++ ou outra linguagem que você decidir explorar.

- Este guia não é só técnico, mas sim um lembrete de que conhecimento compartilhado 
multiplica valor. 

- Que ele sirva como mapa, como capa protetora e como inspiração para que seu VS Code seja, 
de fato, o seu melhor amigo no mundo da programação.

2. Instalação no Windows

# 2.1 Baixar o instalador oficial 
1. Acesse a página do VS Code
2. Faça download para Windows 10/11 (gratuito)
3. Escolha instalação sem privilégios de administrador

# 2.2 Opções recomendadas
1. Add to PATH
- Habilite a opção para usar o comando code no terminal
2. Register as default editor
- Marque abrir arquivos de texto/código no VS Code por padrão
3. Shell Integration
- Habilite “Open with Code” no menu do botão direito do Explorer
- Essas opções tornam o dia a dia mais rápido.

# 2.3 Primeira abertura
1. Confirme o idioma (Português Brasil)
2. Deixe o tema padrão por ora (ajuste depois)
3. Aceite sugestão de extensões para Python/HTML se solicitado

# 2.4 Configurações essenciais
1. Interface e ergonomia
2. Tema Dark” para reduzir fadiga visual
3. Fonte monoespaçada
4. Habilite Editor "Font Ligatures” se usar Fira Code ou Cascadia Code 
(ótimo para ler operadores)
5. Minimap e breadcrumbs
- Ative para navegar pelo código com contexto
6. Formatação e qualidade
- Ative a formatação automática ao salvar 
- Vá em Settings e habilite “Editor
7. Salvar arquivos automaticamente
- Files: Auto Save em afterDelay ajuda a evitar perdas
8. Terminal integrado
9. Default profile
- Selecione PowerShell, Command Prompt ou bash (se usar WSL)
10. Atalhos
- Ctrl+` abre/fecha o terminal embutido
11. Controle de versão
- Git integrado (VS Code já vem com suporte a Git, incluindo staging, 
commits e diffs)

3. Funções das Extensões por linguagem

# 3.1 Python (Microsoft)
- Base para lint, debug, testes e Jupyter 
- Recursos para análise de erros, depuração, suporte a pytest/unittest, notebooks
1. Pylance
- IntelliSense rápido, tipagem e inferência robusta 
2. AutoDocstring
- Gera docstrings nos formatos Google/NumPy/Sphinx
3. Python Test Explorer
- Gerencia e executa testes com interface visual
4. Instale primeiro “Python”, depois “Pylance” para obter recursos de 
linguagem avançados 

# 3.2 JSON
1. Built-in JSON tools
- VS Code válida JSON, mostra erros e suporta schemas
2. Prettier
- Formata JSON com consistência, inclusive ao salvar 
3. Path Intellisense
- Autocompleta caminhos de arquivos em strings (útil em configs) 
5 respostas
# 3.3 Markdown
1. Markdown All in One
- Edição, atalhos, tabela de conteúdos, preview
2. CodeSnap
-Captura trechos de código como imagens para documentação 

# 3.4 HTML/CSS/JS
1. HTML/CSS/JS Language Features (built-in)
- Editor embutido
2. Prettier
- Padroniza HTML/CSS/JS, evitando discussões de estilo 
3. Live Server
- Servidor local com reload para HTML/JS estáticos
4. ESLint
- Linting consistente para JS/TS (se usar Node/Front-end)

# 3.5 C/C++
1. C/C++ (Microsoft)
- IntelliSense, depuração, configurações de build
2. CMake Tools
- Para CMake, integra configuração e geração
3. Clang-Format
- Formatação do código C/C++ ao salvar

# 3.6 Extensões de produtividade e colaboração
1. Remote – SSH
- Edite e depure em servidores remotos via SSH, como se fossem locais
2. Live Share
- Colaboração em tempo real: edição, debug e terminal compartilhados
3. Better Comments
- Melhora a legibilidade de comentários com códigos de cores
4. Vscode-icons
- Ícones de arquivos/pastas para mais clareza visual
5. Code Runner
- Executa snippets rapidamente em várias linguagens, ótimo para testar ideias
PS. A extensão Bracket Pair Colorizer já vem incorporada ao VS Code 

4 Guia Passo a passo de configuração

1. Instalar e Executar VS Code
2. Instalar Python e Pylance
- Abra o VS Code > Extensions (Ctrl+Shift+X), > instale Python e Pylance
3. Formatação automática
- Instale Prettier e habilite > config > Format On Save 
4. Markdown e documentação
- Instale Markdown All in One e CodeSnap para documentar e compartilhar trechos 
5. HTML/CSS/JS
- Adicione Live Server e ESLint se for trabalhar com web
6. C/C++
- Instale C/C++, CMake Tools e Clang-Format conforme seu fluxo
7. Produtividade
- Adicione Path Intellisense, Better Comments, vscode-icons 
8. Git e terminal
- Configure seu Git (nome/email) e selecione o terminal padrão em Settings
9. Workspaces e settings por projeto
- Crie um (.vscode/settings.json) por projeto para regras específicas (ex: estilos do Prettier)
10. Snippets pessoais
- Use “User Snippets” para criar atalhos de código para padrões que você repete
11. Profiles de extensão
- Crie perfis distintos (Web, Python, C/C++) para manter o ambiente leve

5 Instalar extensões via terminal (VS Code instalado)

- Abra o Prompt de Comando ou PowerShell e rode para instalar de uma vez todas
as extensões:
1. code --install-extension ms-python.python
2. code --install-extension ms-python.vscode-pylance
3. code --install-extension esbenp.prettier-vscode
4. code --install-extension yzhang.markdown-all-in-one
5. code --install-extension adpyke.codesnap
6. code --install-extension ms-vscode.cpptools
7. code --install-extension ms-vscode.cmake-tools
8. code --install-extension xaver.clang-format
9. code --install-extension ritwickdey.liveserver
10. code --install-extension dbaeumer.vscode-eslint
11. code --install-extension christian-kohler.path-intellisense
12. code --install-extension aaron-bond.better-comments
13. code --install-extension vscode-icons-team.vscode-icons
14. code --install-extension formulahendry.code-runner

6. Criando o arquivo settings.json

  • No VS Code, vá em File → Preferences → Settings → (abrir JSON no canto superior direito)
  • Insira:
{
  // Aparência
  "workbench.colorTheme": "Default Dark+",
  "workbench.iconTheme": "vscode-icons",
  "editor.fontFamily": "Cascadia Code, Consolas, 'Courier New', monospace",
  "editor.fontLigatures": true,
  "editor.fontSize": 14,
  "editor.lineHeight": 1.6,

  // Produtividade
  "editor.minimap.enabled": false,
  "editor.rulers": [80, 120],
  "editor.renderWhitespace": "boundary",
  "editor.formatOnSave": true,
  "files.autoSave": "afterDelay",

  // Git
  "git.enableSmartCommit": true,
  "git.confirmSync": false,

  // Python
  "python.languageServer": "Pylance",
  "python.analysis.typeCheckingMode": "basic",
  "python.formatting.provider": "autopep8",

  // JSON
  "[json]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },

  // Markdown
  "[markdown]": {
    "editor.wordWrap": "on",
    "editor.quickSuggestions": false
  },

  // HTML / CSS / JS
  "[html]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[javascript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[css]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },

  // C / C++
  "[cpp]": {
    "editor.defaultFormatter": "xaver.clang-format"
  },
  "[c]": {
    "editor.defaultFormatter": "xaver.clang-format"
  }
}

7. Resultado prático

1. Python
- IntelliSense, lint, debug e formatação automática
2. JSON/HTML/JS/CSS
- Formatados com Prettier ao salvar
3. Markdown
- Preview, atalhos e TOC automáticos
4. C/C++
- IntelliSense, debug e formatação com Clang
5. Produtividade extra
- Live Server, Code Runner, Better Comments, ícones e captura de código

8. Guia Prático Sobre Perfis no VS Code

1. O que são perfis
- Permitem criar conjuntos independentes de configurações, extensões e temas
- Exemplos
1. Perfil Python → só extensões de Python, Jupyter, lint
2. Perfil Web → HTML, CSS, JS, Live Server
3. Perfil C/C++ → IntelliSense, CMake, Clang

2. Como criar um perfil
1. Abra o VS Code
2. Vá em Gerenciar (ícone de engrenagem no canto inferior esquerdo) → Perfis → Criar Perfil
3. Escolha
- Novo perfil vazio (começa do zero)
- Copiar do perfil atual (clona suas configs e você ajusta)
- Dê um nome (ex.: “Python Dev”) e um ícone
- Resultado: o VS Code abre uma nova janela já com esse perfil ativo

3. Alternar entre perfis
1. Vá em Gerenciar → Perfis e selecione o desejado
2. O nome do perfil aparece no canto superior da janela, para você saber qual está ativo

8. Extensões e Configurações Recomendadas no VS Code

8.1 Perfil Python

# Extensões
1. code --install-extension ms-python.python
2. code --install-extension ms-python.vscode-pylance
3. code --install-extension ms-toolsai.jupyter
4. code --install-extension njpwerner.autodocstring
5. code --install-extension littlefoxteam.vscode-python-test-adapter

# Configurações recomendadas (settings.json do perfil)
{
  "python.languageServer": "Pylance",
  "python.analysis.typeCheckingMode": "basic",
  "python.formatting.provider": "autopep8",
  "editor.formatOnSave": true,
  "editor.rulers": [80, 120]
}

8.2 Perfil Web (HTML, CSS, JS, Markdown)

# Extensões
1. code --install-extension esbenp.prettier-vscode
2. code --install-extension ritwickdey.liveserver
3. code --install-extension dbaeumer.vscode-eslint
4. code --install-extension yzhang.markdown-all-in-one
4. code --install-extension adpyke.codesnap

# Configurações recomendadas
{
  "editor.formatOnSave": true,
  "[html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
  "[css]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
  "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
  "[markdown]": { "editor.wordWrap": "on" }
}

8.3 Perfil C/C++

# Extensões
1. code --install-extension ms-vscode.cpptools
2. code --install-extension ms-vscode.cmake-tools
3. code --install-extension xaver.clang-format

# Configurações recomendadas
{
  "[cpp]": { "editor.defaultFormatter": "xaver.clang-format" },
  "[c]": { "editor.defaultFormatter": "xaver.clang-format" },
  "editor.formatOnSave": true
}

Perfil 04 - Produtividade Geral

# Extensões
1. code --install-extension esbenp.prettier-vscode # Formatador universal
2. code --install-extension formulahendry.code-runner # Executa snippets de várias linguagens
3. code --install-extension aaron-bond.better-comments # Comentários coloridos e organizados
4. code --install-extension christian-kohler.path-intellisense # Autocompleta caminhos de arquivos
5. code --install-extension vscode-icons-team.vscode-icons # Ícones para arquivos e pastas
6. code --install-extension ms-vsliveshare.vsliveshare # Colaboração em tempo real
7. code --install-extension ms-vscode-remote.remote-ssh # Trabalhar em servidores remotos via SSH
8. code --install-extension streetsidesoftware.code-spell-checker # Correção ortográfica em código e docs

# Configurações recomendadas (settings.json)
{
  // Aparência
  "workbench.colorTheme": "Default Dark+",
  "workbench.iconTheme": "vscode-icons",
  "editor.fontFamily": "Cascadia Code, Consolas, 'Courier New', monospace",
  "editor.fontLigatures": true,
  "editor.fontSize": 14,

  // Produtividade
  "editor.formatOnSave": true,
  "files.autoSave": "afterDelay",
  "editor.minimap.enabled": false,
  "editor.rulers": [80, 120],
  "editor.renderWhitespace": "boundary",

  // Comentários e escrita
  "better-comments.tags": [
    { "tag": "!", "color": "#FF2D00", "strikethrough": false, "underline": false, "bold": true },
    { "tag": "?", "color": "#3498DB", "strikethrough": false, "underline": false, "bold": true },
    { "tag": "TODO", "color": "#FF8C00", "strikethrough": false, "underline": false, "bold": true },
    { "tag": "*", "color": "#98C379", "strikethrough": false, "underline": false, "bold": true }
  ],

  // Correção ortográfica
  "cSpell.language": "en,pt"
}

9 Benefícios e Orientações de Uso

# Benefícios

1. Prettier → formatação consistente em qualquer linguagem
2. Code Runner → testar rapidamente trechos de código sem configurar projeto
3. Better Comments → comentários mais visuais (ex.: TODO, !, ?)
4. Path Intellisense → autocompleta caminhos de arquivos
5. VSCode Icons → organização visual
6. Live Share → colaboração em tempo real com colegas
7. Remote SSH → editar código em servidores remotos direto do VS Code
8. Spell Checker → evita erros de digitação em inglês/português em docs e comentários

Orientações de Uso

1. Abra o VS Code
2. Vá em Gerenciar (config) → Perfis → Criar Perfil
3. Crie um perfil chamado Python, outro Web e outro C/C++
4. Ative cada perfil e rode os comandos de instalação das extensões correspondentes
5. Em cada perfil, abra settings.json e cole as configurações que deixei acima

10 Exportação e Importação de Perfis no VS Code

# Exportação

1. Abra o VS Code
2. Vá em Gerenciar config → Perfis → Exportar Perfil
3. Escolha se quer exportar 
- Somente extensões
- Extensões + configurações (settings.json, atalhos, snippets, etc.)
4. O VS Code gera um link compartilhável (ex.: https://vscode.dev/profile/github/...) 
- Você pode salvar esse link ou enviar para outro PC
- Também pode exportar para um arquivo .code-profile

# Importação

1. No novo PC, abra o VS Code
2. Vá em Gerenciar config → Perfis → Importar Perfil
3. Cole o link exportado ou selecione o arquivo .code-profile
4. O VS Code instala automaticamente as extensões e aplica as configurações

# Dicas
1. Você pode manter vários perfis exportados, um para cada linguagem
2. Se quiser, pode até publicar seus perfis no GitHub e acessá-los direto pelo navegador 
em vscode.dev
3. Perfis exportados incluem extensões, configurações, atalhos, snippets e layout da interface

11 Algoritmo de Restauração de Perfis

 
# 11.1 Entrada
- Perfis criados no seu VS Code (Python, Web, C/C++, Produtividade)
- Extensões e configurações personalizadas

# 11.2 Processo

# 11.2.1 Exportar Perfil

- Vá em config → Perfis → Exportar
- Escolha se quer exportar só extensões ou extensões + configs
- O VS Code gera um link ou um arquivo .code-profile

# 11.2.2. Guardar a “capa”
- Salve esse link ou arquivo com segurança (OneDrive, GitHub, e-mail, pendrive)
- Pense nisso como sua capa de backup: ela envolve tudo que você configurou

# 11.2.3. Importar em nova máquina

- Instale o VS Code
- Vá em config → Perfis → Importar
- Cole o link ou selecione o .code-profile
- O VS Code baixa extensões, aplica configs e restaura seu ambiente
# 11.3 Saída

- Seu novo VS Code fica idêntico ao antigo, com todos os perfis, extensões e ajustes.

# 11.4 Analogia da capa 
- Imagine que cada perfil é um livro (Python, Web, C/C++).
- A exportação cria uma capa protetora que guarda o conteúdo.
- Quando você importa, é como abrir o livro em outra estante com a mesma capa e páginas.

12 Pseudocódigo de Restauração de Perfis


INÍCIO
// Etapa 1: Criar perfis
CriarPerfil("Python")
CriarPerfil("Web")
CriarPerfil("C/C++")
CriarPerfil("Produtividade")

// Etapa 2: Exportar cada perfil
para cada perfil em Perfis:
    ExportarPerfil(perfil)
    GerarLinkOuArquivo(perfil)

// Etapa 3: Guardar a "capa"
ArmazenarCapaEmLocalSeguro()

// Etapa 4: Nova máquina
InstalarVSCode()
para cada perfilExportado em Backup:
    ImportarPerfil(perfilExportado)

// Etapa 5: Resultado
ExibirMensagem("Perfis restaurados com sucesso!")

FIM

13 Checklist para Restauração de Perfis


# 13.1 Antes da migração
- [ ] Criar perfis separados (Python, Web, C/C++, Produtividade).
- [ ] Ajustar extensões e configurações em cada perfil.
- [ ] Exportar cada perfil ( config → Perfis → Exportar).
- [ ] Salvar os links ou arquivos .code-profile em local seguro (OneDrive, GitHub, pendrive).

# 13.2 Na nova máquina
- [ ] Instalar o VS Code.
- [ ] Acessar config → Perfis → Importar.
- [ ] Colar o link ou selecionar o arquivo .code-profile.
- [ ] Confirmar instalação automática das extensões.
- [ ] Verificar se as configurações (tema, atalhos, formatação) foram aplicadas.

# 13.3 Depois da restauração
- [ ] Testar cada perfil (abrir um projeto Python, um HTML, um C++).
- [ ] Ajustar detalhes finos (atalhos, fontes, preferências pessoais).
- [ ] Fazer um novo backup/exportação se houver mudanças importantes.

14 Considerações Finais


- Este guia não é apenas sobre configurar um editor de código. 
- É sobre criar um ambiente que viaja com você, que guarda sua lógica, suas preferências 
e sua forma de trabalhar.
- Cada perfil é um palco, cada extensão é um instrumento, e o VS Code se torna mais 
do que uma ferramenta: torna-se um parceiro. 
- Porque conhecimento não foi feito para ficar trancado — foi feito para ser vivido, compartilhado
e multiplicado.
- Com este manual de bolso, você tem em mãos a chave para transformar o seu VS Code no melhor 
amigo da sua criatividade.

15 Fontes de Referência

1.  Documentação do VS Code sobre Perfis 
2. Visual Studio CodeVS Code Docs – Profiles 
3. github.com
4. Visual Studio Code 
5. DEV Community
6. DEV CommunityDev.to – Criando diferentes perfis no VS Code
7. GeeksForGeeks
8. Kinsta

Bom dia, meu amigo Ricardo! Como vai?

Novamente com suas postagens que são praticamente artigos, vendo todas às vezes essas postagens suas me fez pensar, porque você não pensa em fazer um artigo encorpado para a plataforma do medium.

Quase 100% dos artigos que leio hoje em dia vem de lá e se não me engano você pode publicar gratuitamente na plataforma. Fica a dica caso queira se centrar mais na ideia de publicação.

Alura Conte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!
solução!

Oi Armando, obrigado pela sugestão! Vou acessar o link agora mesmo para conhecer a proposta de trabalho deles. Sou filho de uma escritora, professora e trovadora, e cresci vendo minha mãe escrever. Tenho uma grande paixão por escrever. Abraços, Ricardo.