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