Guia Completo para Instalar e Usar o Visual Studio Code no Ubuntu (Edição 2025)

.

1. Introdução: Por que usar o VS Code no Ubuntu?

Visual Studio Code (doravante referido como VS Code) é um editor de código-fonte leve, porém extremamente poderoso. Fornecido pela Microsoft, ele é amplamente adotado por desenvolvedores ao redor do mundo graças à sua base de código aberto e excelente extensibilidade. Além de Windows e macOS, ele funciona de forma estável em sistemas operacionais baseados em Linux.

Entre eles, o Ubuntu é uma das distribuições Linux mais usadas globalmente. Ele oferece versões oficiais de Long Term Support (LTS), proporcionando forte estabilidade e segurança. O Ubuntu é gratuito e se beneficia de um ecossistema rico de pacotes e de forte apoio da comunidade, tornando‑o adequado tanto para desenvolvimento individual quanto para uso profissional.

As vantagens de usar o VS Code no Ubuntu incluem:

• Leve e desempenho rápido: funciona suavemente mesmo em máquinas de baixa especificação ou em ambientes de nuvem
• Ecossistema extenso de extensões: adicione facilmente suporte a linguagens, integração com Git, recursos de desenvolvimento remoto e muito mais
• Consistência multiplataforma: a mesma experiência de usuário em diferentes sistemas operacionais
• Suporte oficial: a Microsoft fornece pacotes oficiais para Ubuntu com gerenciamento de atualizações simplificado

Este artigo explica, passo a passo, desde a instalação do VS Code no Ubuntu até a localização para o japonês, configuração do ambiente de desenvolvimento, desenvolvimento remoto e uso de contêineres. Seja você iniciante no Ubuntu ou esteja considerando migrar de outro editor, este guia ajudará a montar um ambiente completo do VS Code no menor tempo possível.

2. Comparação de Métodos de Instalação: Snap / APT (Repositório Microsoft) / DEB Oficial

Ao instalar o VS Code no Ubuntu, há três métodos principais disponíveis. Compare suas características, vantagens e desvantagens para escolher o que melhor se adapta às suas necessidades.

2-1. Snap (Centro de Software ou CLI)

Características

• Distribuído no formato Snap, o sistema padrão de gerenciamento de pacotes do Ubuntu.
• Pode ser instalado com um único clique a partir do Ubuntu Software Center.
• Pelo terminal, a instalação é feita usando sudo snap install --classic code.

Vantagens

• Instalação GUI fácil, ideal para iniciantes.
• Atualizações automáticas aumentam a segurança e garantem acesso aos recursos mais recentes.

Desvantagens

• Devido ao sandboxing, foram relatados problemas de compatibilidade com IME ou temas.
• A inicialização e a responsividade podem parecer um pouco mais lentas.

2-2. APT (via Repositório Oficial da Microsoft)

Características

• Utiliza o repositório APT oficial da Microsoft para gerenciar o VS Code com apt.
• Após registrar o repositório usando um arquivo .deb, o gerenciamento é feito com sudo apt update && sudo apt install code.

Vantagens

• Integrado ao gerenciamento padrão do APT para atualizações consistentes do sistema.
• Alta compatibilidade com métodos de entrada japoneses e outros recursos essenciais.
• Controle de atualização simples e claro.

Desvantagens

• O registro inicial do repositório requer etapas adicionais.
• Pode parecer menos acessível para usuários acostumados apenas a instalações via GUI.

Linux Software Repository for Microsoft Products

Learn how to install Microsoft products on Linux using the p…

Technically Impossible

Microsoftレポジトリを登録し、Edge、VSCode、PowerShellを”apt install”する。 - Technically Impossible

Ubuntuでのパッケージ・マネジャーと言えば”apt”だが、そのレポジトリでVSCodeは提供されていない。Ubunt…

2-3. Instalação Autônoma Usando o Pacote DEB Oficial

Características

• Baixe o pacote .deb diretamente do site oficial da Microsoft.
• Instale usando sudo apt install ./code_*.deb, que resolve dependências automaticamente.

Vantagens

• Conveniente para ambientes offline ou com rede restrita.
• Não é necessário registrar um repositório para a instalação inicial.

Desvantagens

• Atualizações automáticas exigem configuração manual do repositório posteriormente.
• Menos conveniente para manutenção a longo prazo comparado aos métodos Snap ou APT.

2-4. Qual Método Você Deve Escolher?

• Facilidade de uso / foco em GUI → Snap (Ubuntu Software Center)
• Estabilidade / entrada japonesa e extensibilidade → APT (Repositório Oficial)
• Instalação única / configuração mínima → DEB Oficial (Autônomo)

Para desenvolvimento diário com uso a longo prazo, o método APT (oficial da Microsoft) oferece o melhor equilíbrio e gerenciamento simples de atualizações. O Snap é conveniente para testes rápidos ou uso experimental, enquanto o pacote DEB oficial é ideal para ambientes restritos ou de verificação.

Com base nessa comparação, a próxima seção explica o procedimento de instalação recomendado usando o método “Integração DEB Oficial → APT” com exemplos concretos de comandos.

3. Procedimento A: Instalar via DEB Oficial com Integração APT (Recomendado)

Nesta seção, você instalará o VS Code usando o pacote .deb oficial recomendado pela Microsoft, registrando simultaneamente o repositório APT para garantir acesso contínuo às versões mais recentes. Este método oferece alta estabilidade para entrada em japonês e ajuda a evitar problemas de compatibilidade com IME às vezes relatados na versão Snap.

3-1. Baixar o Pacote DEB do Site Oficial

1. Abra seu navegador e visite a página oficial de download do Visual Studio Code.
2. Clique no botão .deb (para Debian/Ubuntu) para baixar o pacote.

3-2. Instalar via Terminal

Se o arquivo baixado estiver localizado em ~/Downloads, execute os seguintes comandos:

cd ~/Downloads
sudo apt install ./code_*.deb

• Passar o arquivo .deb diretamente para apt install resolve automaticamente as dependências necessárias.
• Este processo também registra o repositório APT da Microsoft.

3-3. Verificar a Instalação

Verifique a versão instalada usando o seguinte comando:

code --version

Alternativamente, procure por “Visual Studio Code” no menu de aplicativos e inicie-o.

3-4. Atualizando o VS Code

Uma vez que o repositório APT estiver registrado, o VS Code será atualizado junto com as atualizações do sistema:

sudo apt update
sudo apt upgrade

3-5. Desinstalando (Referência)

Se você precisar remover o VS Code, execute:

sudo apt remove code
sudo apt autoremove

Com esta configuração, você pode continuar usando a versão mais recente do VS Code com manutenção mínima.

4. Procedimento B: Instalar Usando Snap (GUI / CLI)

O Snap é o formato padrão de distribuição de pacotes do Ubuntu e permite instalação via Software Center (GUI) ou operações simples de linha de comando. É particularmente conveniente para iniciantes ou aqueles que querem uma configuração rápida sem configurações detalhadas.

4-1. Instalar do Software Center (GUI)

1. Abra o Ubuntu Software do menu de aplicativos.
2. Digite “Visual Studio Code” ou “code” na barra de pesquisa.
3. Selecione “Visual Studio Code” e clique no botão Instalar.
4. Digite sua senha e aguarde a conclusão da instalação.

4-2. Instalar da Linha de Comando (CLI)

Abra um terminal e digite o seguinte comando:

sudo snap install --classic code

• A opção --classic é necessária para conceder acesso padrão ao sistema de arquivos.
• O download e a instalação geralmente são concluídos em poucos minutos.

4-3. Verificar a Instalação

code --version

Ou inicie “Visual Studio Code” do menu de aplicativos.

4-4. Atualizações e Remoção

• A versão Snap atualiza automaticamente, então atualizações manuais geralmente não são necessárias.
• Para removê-lo, execute:

  sudo snap remove code
  

4-5. Notas sobre a Versão Snap

• Entrada em Japonês : Dependendo do ambiente e configurações do IME, problemas de entrada foram relatados. Mudar para o método DEB → APT frequentemente resolve esses problemas.
• Velocidade de Inicialização : Devido à estrutura de sandboxing do Snap, o primeiro lançamento pode ser ligeiramente mais lento.

5. Configuração Inicial: Localização, Fontes e Ajustes de Exibição

Após instalar o VS Code no Ubuntu, os primeiros passos devem ser a localização e a otimização da legibilidade. Uma configuração adequada nesta etapa torna o desenvolvimento futuro muito mais suave.

5-1. Localização (Instalando o Pacote de Idioma Japonês)

1. Inicie o VS Code e clique no ícone de Extensões (ícone de quatro quadrados) à esquerda.
2. Digite Japanese Language Pack na barra de pesquisa.
3. Instale “Japanese Language Pack for Visual Studio Code”.
4. Após a instalação, clique em [Change Language] no popup exibido no canto inferior direito.
5. Reinicie o VS Code para aplicar a interface em japonês.

Para alternar manualmente, abra a paleta de comandos com Ctrl+Shift+P (ou F1), digite Configure Display Language e selecione ja.

5-2. Configurações de Fonte

Para programação, fontes monoespaçadas com distinção clara entre caracteres de largura total e meia largura são recomendadas.

1. Abra [File] → [Preferences] → [Settings] .
2. Digite “font family” na barra de pesquisa.
3. Defina a fonte preferida (por exemplo, Cascadia Code , Fira Code , Noto Sans Mono CJK JP ).

Usar fontes com ligaduras ativadas melhora a clareza visual de símbolos como => e ===.

5-3. Ajustes de Exibição (Temas e Ícones)

• Seleção de tema : Pressione Ctrl+K → Ctrl+T para abrir o seletor de temas.
• Temas de ícones : Use Ctrl+Shift+P → File Icon Theme para alterar conjuntos de ícones.

5-4. Configurações Iniciais Adicionais Recomendadas

• Mostrar números de linha : Defina editor.lineNumbers como on .
• Formatar ao salvar : Ative editor.formatOnSave .
• Salvar automaticamente : Defina files.autoSave como afterDelay .

O ambiente de trabalho básico está agora pronto. A próxima seção introduz extensões essenciais e exemplos de configuração para melhorar ainda mais a produtividade.

6. Extensões Comumente Usadas e Configuração Básica (Configuração nos Primeiros 10 Minutos)

Uma das maiores forças do VS Code é sua capacidade de adicionar funcionalidades facilmente por meio de extensões. Esta seção introduz extensões essenciais para instalar imediatamente após a configuração no Ubuntu, juntamente com itens de configuração fundamentais que melhoram significativamente a eficiência de desenvolvimento.

6-1. Extensões Essenciais

1. Japanese Language Pack for Visual Studio Code

• Uma extensão obrigatória para exibição de interface em japonês, explicada anteriormente.

1. Python

• Essencial para desenvolvimento em Python, fornecendo linting, conclusão de código e depuração.
• Quando combinada com a extensão Jupyter, o desenvolvimento no estilo de notebook também é suportado.

1. C/C++

• Fornece conclusão de código, depuração e realce de sintaxe para C e C++.
• Recomenda-se usar junto com o pacote build-essential.

1. GitLens

• Exibe visualmente o histórico do Git e diffs, tornando-o extremamente útil para desenvolvimento em equipe e rastreamento de alterações.

1. Remote Development Pack

• Um pacote integrado que permite desenvolvimento via SSH, dentro de contêineres Docker ou no WSL.
• Explicado em mais detalhes na seção de Desenvolvimento Remoto.

1. Prettier – Code Formatter

• Formata o código automaticamente. Suporta JavaScript, TypeScript, HTML e CSS.

6-2. Itens de Configuração Inicial

• Formatar ao salvar

  "editor.formatOnSave": true
  

Isso garante formatação consistente toda vez que você salvar um arquivo.

• Largura da aba e indentação

  "editor.tabSize": 4,
  "editor.insertSpaces": true
  

Ajuste esses para corresponder aos padrões de codificação da sua equipe.

• Inserir nova linha final

  "files.insertFinalNewline": true
  

• Mostrar números de linha

  "editor.lineNumbers": "on"
  

• Remover espaços em branco no final

  "files.trimTrailingWhitespace": true
  

6-3. Ativando a Sincronização de Configurações

Faça login com uma conta do VS Code (Microsoft ou GitHub) e ative Settings Sync para sincronizar automaticamente configurações e extensões em vários PCs ou após reinstalação.

Nesse ponto, o ambiente de desenvolvimento principal está essencialmente completo.

7. Configuração Mínima de Ambiente Específico de Linguagem

Esta seção explica como configurar rapidamente ambientes de desenvolvimento para Python e C/C++, que são comumente usados no Ubuntu. Ao adicionar essas configurações a uma instalação nova do VS Code, você pode iniciar o desenvolvimento prático imediatamente.

7-1. Configuração do Ambiente Python

.1. Instale o Python e as ferramentas de ambiente virtual

sudo apt update
sudo apt install python3 python3-venv python3-pip

• python3-venv fornece ambientes isolados por projeto.
• pip é o gerenciador de pacotes.

1. Instale as extensões do VS Code

• Instale a extensão oficial Python.
• Opcionalmente, instale Jupyter para fluxos de trabalho baseados em notebooks.

1. Crie e ative um ambiente virtual

   python3 -m venv .venv
   source .venv/bin/activate
   

O VS Code detecta automaticamente o ambiente virtual e o lista no menu de seleção de interpretador.

4. Configuração de lint e formatação (exemplo: ruff e black)

   pip install ruff black
   

Configure o VS Code para executar black para formatação e ruff para análise estática ao salvar.

7-2. Configuração do Ambiente C/C++

1. Instale compiladores e pacotes essenciais

   sudo apt update
   sudo apt install build-essential gdb
   

• Inclui gcc, g++ e o depurador gdb.

1. Instale as extensões do VS Code

• Instale a extensão oficial C/C++.
• Opcionalmente, adicione CMake Tools.

1. Configure tarefas de compilação

• Abra a paleta de comandos (Ctrl+Shift+P) e selecione “Tasks: Configure Default Build Task”.
• Escolha g++ build active file.
• Isso permite compilar o arquivo atual com Ctrl+Shift+B.

1. Configure a depuração

• Pressione F5 e selecione “C++ (GDB/LLDB)”.
• Um arquivo .vscode/launch.json é criado, habilitando a depuração baseada em breakpoints.

7-3. Verificação e Execução de Testes

Exemplo em Python

print("Hello, Python on Ubuntu!")

Exemplo em C++

#include <iostream>
using namespace std;

int main() {
    cout << "Hello, C++ on Ubuntu!" << endl;
    return 0;
}

Salve o arquivo, compile o C++ com Ctrl+Shift+B e execute o executável gerado para verificar a funcionalidade.

8. Desenvolvimento Remoto: Remote SSH / Dev Containers / Codespaces

O VS Code oferece desenvolvimento confortável não apenas em máquinas locais, mas também em servidores remotos e ambientes conteinerizados. No Ubuntu, combinar esses recursos melhora significativamente a flexibilidade e a reprodutibilidade.

8-1. Remote SSH

Visão geral

Edite e execute código localizado em um servidor remoto diretamente do seu VS Code local. Um servidor VS Code roda no host remoto, proporcionando uma experiência semelhante à local.

Procedimento

1. Instale o Remote Development Pack (inclui Remote – SSH).
2. Adicione os detalhes de conexão ao ~/.ssh/config. Exemplo:

   Host myserver
       HostName 192.168.0.50
       User ubuntu
       IdentityFile ~/.ssh/id_rsa
   

3. Abra a paleta de comandos e selecione “Remote-SSH: Connect to Host”, então escolha myserver.

Vantagens

• Edite, execute e depure código sem precisar fazer login direto no servidor.
• Mantenha os ambientes locais limpos enquanto desenvolve projetos específicos do servidor.

8-2. Dev Containers

Visão geral

Use contêineres Docker como ambientes de desenvolvimento no VS Code. A configuração é armazenada em um diretório .devcontainer, permitindo que qualquer pessoa trabalhe com a mesma configuração.

Procedimento

1. Instale Docker e Docker Compose no Ubuntu.
2. Instale a extensão Dev Containers.
3. Crie .devcontainer/devcontainer.json na raiz do projeto. Exemplo:

   {
       "name": "Python Dev",
       "image": "python:3.11",
       "features": {},
       "settings": {
           "terminal.integrated.shell.linux": "/bin/bash"
       }
   }
   

4. Selecione “Dev Containers: Reopen in Container” na paleta de comandos.

Vantagens

• Isola completamente dependências e toolchains por projeto.
• Garante ambientes consistentes entre os membros da equipe.

8-3. GitHub Codespaces

Visão geral

Um ambiente VS Code baseado na nuvem fornecido pelo GitHub. Acessível via navegador, permitindo desenvolvimento instantâneo sem configuração local.

1. Abra um repositório do GitHub.
2. Selecione “Code” → “Codespaces” → “New codespace”.
3. Em segundos, um ambiente em nuvem é iniciado com o VS Code no navegador.
4. Opcionalmente, conecte-se a partir do VS Code local.

Vantagens

• Permite desenvolvimento completo mesmo em dispositivos de baixa especificação.
• Trabalhe de qualquer lugar com um ambiente consistente.

9. Problemas Comuns e Solução de Problemas

Dependendo do ambiente e do método de instalação, vários problemas podem ocorrer ao usar o VS Code no Ubuntu. Esta seção resume problemas comuns e soluções.

9-1. Entrada em Japonês Não Funciona ou É Instável

Causas

• Problemas de compatibilidade com IME na versão Snap.
• Métodos de entrada não funcionando corretamente em ambientes de sandbox.

Soluções

• Desinstale a versão Snap e reinstale usando o método oficial DEB (integrado ao APT).
• Reconfigure fcitx ou ibus se necessário.

9-2. Inicialização Lenta ou Desempenho Ruim

Causas

• Inicialização do sandbox Snap ou carregamento pesado de extensões.
• Muitas extensões desnecessárias ativadas.

Soluções

• Inicie com code --disable-extensions para identificar extensões problemáticas.
• Mudar do Snap para DEB frequentemente melhora o desempenho.

9-3. Certas Extensões Não Funcionam

Causas

• Bibliotecas ausentes ou incompatibilidades com a versão do Ubuntu.
• Problemas de permissões em ambientes de contêiner ou remotos.

Soluções

• Instale dependências necessárias usando sudo apt install .
• Verifique permissões de acesso para caminhos necessários.

9-4. Problemas de Exibição ou Entrada no Wayland

Causas

• O VS Code frequentemente roda via XWayland, e a compatibilidade nativa com Wayland não está totalmente madura.

Soluções

• Faça login usando uma sessão Xorg.
• Ou inicie com a seguinte opção:

  code --ozone-platform=x11
  

9-5. Desinstalação Completa

Soluções

• Versão DEB:

  sudo apt remove code
  sudo apt autoremove
  rm -rf ~/.config/Code
  

• Versão Snap:

  sudo snap remove code
  rm -rf ~/.config/Code
  

10. Política de Segurança e Atualizações

Para o uso de longo prazo do VS Code no Ubuntu, manter a segurança e a funcionalidade atualizada é essencial.

10-1. Comportamento de Atualização por Método de Instalação

1. APT (Repositório Oficial)

• As atualizações são aplicadas junto com as atualizações do sistema usando sudo apt update && sudo apt upgrade .
• Fornece um bom equilíbrio entre estabilidade e novos recursos.

1. Snap

• Atualizado automaticamente pelo snapd.
• O momento da atualização depende da programação do snapd.

1. DEB Autônomo (Sem Repositório)

• Sem atualizações automáticas.
• Reinstalação manual é necessária para novas versões.

10-2. Considerações de Segurança

• Use fontes confiáveis
• Sempre baixe do site oficial ou repositórios da Microsoft.
• Evite PPAs não oficiais ou pacotes de terceiros.
• Seleção de extensões
• Verifique editores e avaliações.
• Evite extensões que não foram atualizadas há muito tempo.
• Gerenciamento de permissões
• Gerencie estritamente chaves e permissões para Remote SSH e contêineres.
• Evite exposição desnecessária de portas e contêineres root no Docker.

10-3. Frequência de Atualização Recomendada

• Focado em estabilidade : Atualize a cada poucas semanas alinhado com as agendas do Ubuntu LTS.
• Focado em recursos : Verifique atualizações semanalmente.
• Usuários Snap : Confie em atualizações automáticas, considere rollback com sudo snap revert code se problemas ocorrerem.

11. Resumo: Construa um Ambiente Ubuntu × VS Code Totalmente Usável Rapidamente

Este artigo cobriu métodos de instalação, configuração inicial, ambientes de linguagem, desenvolvimento remoto, solução de problemas e segurança. Abaixo está um roteiro conciso para configuração rápida.

11-1. Passos de Configuração Mais Rápida

1. Instalação

• Escolha DEB Oficial → Integração APT para estabilidade e atualizações fáceis.
• Use Snap para testes rápidos, notando possíveis problemas com IME.

1. Configuração inicial

• Instale o Pacote de Idioma Japonês.
• Ajuste fontes e temas.
• Ative a formatação ao salvar e os números de linha.

1. Extensões essenciais

• Python, C/C++, GitLens, Pacote de Desenvolvimento Remoto, Prettier.
• Ative a Sincronização de Configurações.

1. Configuração do ambiente de linguagem

• Python: ambientes virtuais e ferramentas de lint/formatação.
• C/C++: compilador, depurador, tarefas de build e debug.

1. Desenvolvimento remoto

• Remote SSH para desenvolvimento baseado em servidor.
• Dev Containers para isolamento de projetos.
• GitHub Codespaces para fluxos de trabalho baseados em nuvem.

1. Segurança e atualizações

• Use apenas fontes oficiais.
• Realize atualizações regulares via APT ou Snap.

11-2. Como Usar Este Artigo

• Usuários novos do Ubuntu podem alcançar um ambiente de desenvolvimento totalmente funcional em uma hora seguindo este guia passo a passo.
• Usuários migrando de outros editores podem melhorar consideravelmente a eficiência usando as extensões e recursos remotos do VS Code.
• Em caso de problemas, o Capítulo 9 fornece soluções de recuperação rápidas.

FAQ

P1. Devo usar a versão Snap ou APT?
R. Para estabilidade a longo prazo, a versão APT (via DEB oficial) é recomendada. O Snap é aceitável para testes de curto prazo, mas pode diferir no comportamento do IME e na velocidade de inicialização.

P2. Como ativar a localização em japonês?
R. Instale o “Japanese Language Pack for Visual Studio Code” e selecione ja via Configure Display Language, depois reinicie.

P3. A entrada em japonês não funciona. O que devo fazer?
R. Se estiver usando Snap, mude para a versão DEB oficial. Além disso, verifique a configuração do ibus ou fcitx.

P4. O que é necessário para começar o desenvolvimento em Python?
R. Instale o Python, python3-venv e pip, depois adicione a extensão Python no VS Code.

P5. A compilação em C/C++ falha.
R. Instale o build-essential e gdb, ative a extensão C/C++ e configure as tarefas de build.

P6. Como usar o Remote SSH?
R. Instale o Pacote de Desenvolvimento Remoto, configure o ~/.ssh/config e conecte via paleta de comandos.

P7. O que são Dev Containers?
R. Eles permitem que contêineres Docker sejam usados como ambientes de desenvolvimento isolados definidos por .devcontainer.

P8. Com que frequência devo atualizar?
R. Para estabilidade, atualize a cada poucas semanas. Para novos recursos, atualize semanalmente. O Snap atualiza automaticamente.