Resolvendo o erro "libQt6Widgets.so.6: cannot open shared object file" no Linux
Publicado por Xerxes em 10/06/2025
[ Hits: 532 ]
Quem nunca se deparou com uma mensagem de erro ao tentar executar um programa recém-instalado ou um desenvolvimento próprio, não é mesmo? Uma dessas mensagens comuns, especialmente para aplicações que utilizam interface gráfica com Qt, é:
/usr/local/bin/SeuPrograma: error while loading shared libraries: libQt6Widgets.so.6: cannot open shared object file: No such file or directory
Essa mensagem indica que o seu sistema não conseguiu encontrar a biblioteca compartilhada libQt6Widgets.so.6
, essencial para que o programa funcione. Mas não se preocupe, a solução geralmente é simples!
libQt6Widgets.so.6
é um componente fundamental do Qt 6, mais especificamente do módulo QtWidgets. Bibliotecas compartilhadas (.so - Shared Object) no Linux são como DLLs no Windows: pedaços de código que podem ser usados por múltiplos programas. Se a biblioteca não está instalada ou o sistema não sabe onde encontrá-la, o programa não consegue iniciar.
A forma mais comum de corrigir esse problema é instalando o pacote que contém a biblioteca libQt6Widgets.so.6
. Veja como fazer nas distribuições mais populares:
Abra seu terminal e utilize o comando correspondente à sua distribuição:
sudo apt update && sudo apt install libqt6widgets6
sudo dnf install qt6-qtwidgets
sudo pacman -Syu qt6-widgets
sudo zypper install libQt6Widgets6
Observação: Se você não tiver certeza do nome exato do pacote, pode usar o mecanismo de busca do seu gerenciador de pacotes. Por exemplo, no Debian/Ubuntu: apt search qt6 widgets
.
Após a instalação, é uma boa prática atualizar o cache das bibliotecas compartilhadas do sistema. Isso garante que o sistema reconheça a nova biblioteca instalada:
sudo ldconfig
Agora, tente executar seu programa novamente. Na maioria dos casos, o erro já estará resolvido!
Se o problema persistir, verifique se você possui todas as dependências do Qt6 instaladas. Você pode instalar o pacote completo de desenvolvimento do Qt6 com:
sudo apt install qt6-base-dev
sudo dnf install qt6-qtbase-devel
sudo pacman -S qt6-base
FoFix: Evolução do Fretsonfire no Arch Linux
Baixar e ler mangás grátis no Linux e no Android
Imprimindo no formato livreto no Linux
Consertando [HOME] e [END] no Aterm
elementary OS: Habilitando repositórios estáveis
Atualizando o VMware-Sever no Ubuntu 8.10 Hardy Heron
from xdg.DesktopEntry import DesktopEntry
Qt 6.10 e Python 3.14 puxam o ritmo do software livre nesta quarta
Atualizações de Apps, Desktop e Kernel agitam o ecossistema Linux nesta terça-feira
Miyoo Mini Plus + Onion OS (Linux)
IA local no bolso, novo visual no Raspberry Pi OS e mais destaques do software livre
Kernel turbinado, compatibilidade em alta e debate sobre sustentabilidade: o dia no mundo Linux
Como mudar o nome de dispositivos Bluetooth via linha de comando
Adicionando o repositório backports no Debian 13 Trixie
Como listar os arquivos em "bloquin... [RESOLVIDO] (6)
Como colocar atalho para uma pasta na área de trabalho do Ubuntu 24.04... (2)