Como instalar o Visual Studio Code via Flatpak no Big Linux (sem glitches)

Se você usa o Big Linux — uma distribuição brasileira baseada no Arch Linux — e quer instalar o Visual Studio Code de forma estável, integrada ao GNOME + Wayland e sem comportamento estranho entre ícone e terminal, o Flatpak é hoje a opção mais confiável (ou a que melhor funcionou no meu caso).

Este guia foi escrito após resolver problemas reais, como:

• VS Code não abre e retorna touch: comando não encontrado
• Comando code falha mesmo com o editor instalado
• Conflitos entre .bashrc, .zshrc e aliases antigos
• Editor abre pelo ícone, mas não pelo terminal (ou o contrário)

Não vamos apenas instalar, mas a entender e corrigir os problemas mais comuns nesse cenário.

Por que Flatpak (e não AUR ou script manual)?

No Big Linux, o VS Code pode ser instalado via AUR, pacotes modificados ou scripts manuais, mas essas abordagens frequentemente apresentam:

• Glitches visuais no Wayland
• Ícones quebrados no GNOME
• Diferença de comportamento entre launcher gráfico e terminal

O Flatpak empacota o VS Code com todas as dependências corretas e usa o app-id oficial com.visualstudio.code, garantindo:

• Versão oficial da Microsoft
• Integração consistente com GNOME e Wayland
• Atualizações automáticas e previsíveis

Dica importante: Se você já tentou instalar o VS Code antes, remova tudo e comece do zero. Resíduos antigos são a principal causa de erro.

Passo 0: Limpeza de instalações antigas

yay -Rns visual-studio-code-bin 2>/dev/null || true

sudo rm -f /usr/bin/code /usr/local/bin/code /usr/sbin/code

# se caso ja tentou instalar com flatpak antes e teve problema, tambem remova
flatpak uninstall com.visualstudio.code -y

Revise também seus arquivos .bashrc, .zshrc e .profile e remova aliases ou funções antigas relacionadas ao comando code.

Atenção: ~/.config/Code contém extensões e configurações. Faça backup se quiser preservar.

Passo 1: Verifique o Flatpak

sudo pacman -S flatpak
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Reinicie a sessão para garantir que as permissões estejam ativas.

Passo 2: Instale o VS Code via Flatpak

flatpak install flathub com.visualstudio.code

O Flatpak irá baixar automaticamente o runtime necessário (org.freedesktop.Platform).

Passo 3: Configure o comando code

Opção recomendada: wrapper global

sudo tee /usr/local/bin/code <<'EOF'
#!/bin/sh
exec flatpak run com.visualstudio.code --no-sandbox "$@"
EOF

sudo chmod +x /usr/local/bin/code

Essa abordagem funciona em qualquer shell, script ou launcher gráfico, sem depender de arquivos de configuração do usuário.

O parâmetro --no-sandbox é necessário porque o sandbox do Chromium não funciona corretamente dentro do Flatpak. O isolamento já é garantido pelo próprio Flatpak via namespaces e bubblewrap.

Testes finais

code --version
code .

O editor deve abrir exatamente igual ao ícone do menu: sem glitches, integrado ao Wayland e com comportamento consistente.

Problemas comuns

Erro: touch: comando não encontrado

Isso indica um runtime incompleto ou corrompido. Reinstale tudo:

flatpak uninstall com.visualstudio.code -y
flatpak install flathub com.visualstudio.code -y

O comando code aponta para função ou alias

type code
unset -f code
unalias code

Depois, revise seus arquivos de configuração de shell.

Conclusão

Com o VS Code instalado via Flatpak no Big Linux, você obtém uma instalação limpa, previsível e alinhada com o ambiente GNOME + Wayland — além de um comando code funcional em qualquer contexto.

Sobre este guia

Testado no Big Linux 25, GNOME 47 e Wayland.
Compatível também com Manjaro, EndeavourOS e outras distros Arch-based.

Seu VS Code agora funciona como deveria — sem gambiarras.