Resolvendo o erro "libQt6Widgets.so.6: cannot open shared object file" no Linux

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!

O que é esse arquivo e por que ele não é encontrado?

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.

Como resolver?

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:

1. Instale a biblioteca Qt6 Widgets:

Abra seu terminal e utilize o comando correspondente à sua distribuição:

• Para Debian, Ubuntu e derivados (Mint, Pop!_OS, etc.):

  sudo apt update && sudo apt install libqt6widgets6

• Para Fedora:

  sudo dnf install qt6-qtwidgets

• Para Arch Linux e derivados (Manjaro, EndeavourOS, etc.):

  sudo pacman -Syu qt6-widgets

• Para openSUSE:

  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.

2. Atualize o cache das bibliotecas:

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

3. Teste novamente!

Agora, tente executar seu programa novamente. Na maioria dos casos, o erro já estará resolvido!

Dica adicional

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:

• Debian/Ubuntu: sudo apt install qt6-base-dev
• Fedora: sudo dnf install qt6-qtbase-devel
• Arch: sudo pacman -S qt6-base

rename - Comando para renomear todos os arquivos para letra minúscula

Adicionando esquemas de cores ao Geany

Funtoo - Montando dispositivos automaticamente

Fácil: Watchtower Library no Linux

Jogue de graça Brutal Doom: Hell on Earth Starter Pack

Manjaro Linux sem som? Instale pacotes multimídia

Corrigindo "Signature is unknown trust" no Arch Linux

Instalando tema QtCurve no GTK do KDE 4.4

Ubuntu com cara de Windows 7/8 - Muito fácil!

Definindo a placa de som padrão no Ubuntu